Manual

Getting started

Install the License

If you have purchased a license in the iTap mobile store please read the following instructions carefully. If you have obtained the license via the Mac Appstore you can skip this chapter and start with - Preparing the Windows PC for iTap mobile RDP.

Look up the License Code

Enter the iTap mobile store and select the Licenses option in the menu. Copy the appropriate license code from your list. A license code consists of nine digits either numbers or capital letters separated by a hyphen- e.g. LXYZ-1234.

Install the License

In order to import the license please make sure that you have the license code ready. Start Tap mobile RDP and open the licensing dialog from the application's main menu.

Click the middle button in the licensing dialog at the bottom. Next enter your license code in the text field and submit by clicking okay.

The license will be downloaded and installed automatically. After a successful installation you should see a line added in the license dialog.

Enable secondary/right click on Mac

When using a Apple Magic Mouse, Apple Magic Trackpad or Macbook Trackpad you will need to enable the right click or secondary click as not enabled by default with this devices:

  • Open the "System Preferences"
  • Click "Mouse" or "Trackpad"
  • Enable Secondary Click

The right click is needed for actions in the Connection center or in a running session.

Preparing the Windows PC

RDP is an integrated feature of Microsoft Windows (except home editions, see this FAQ entry). On all non-server editions RDP has to be enabled before it can be used. To do so, please follow the guides for your installed version of Microsoft Windows.

On our webpage we offer a high-level set-up guide for Windows XP, Windows Vista and Windows 7.

Getting to know the Interface

The Connection Center

After starting iTap mobile RDP you will see the connection center. From here you can either

  • add new connections
  • connect to or edit existing connections from your bookmark list.

Additionally you have the possibility to set global preferences which will be explained later.

Using the search field below the toolbar you can search for computers or servers within your bookmark list. This field becomes very useful when many entities are managed.
NOTE: The search just considers the label or host information.

After the first application start just the bookmark “iTap RDP Testserver” is visible. Each bookmark in the list shows following information:

The test status informs you about the health of the connection to your computer or server. The connection test is enabled by default and can be disabled within the bookmark settings. shows that everything is ok, while will appear if there is an connection issue.If you open the bookmark an error dialog will give you more information on this issue. will appear if network testing is disabled for this host or in case of a gateway connections as gateway connections never have a connection test.

If the connection test succeeds then a small icon below the test status will show the security level of the connection. The number of dots indicates the security strength. One dot indicates basic security (up to 140 bit FIPS compliant but with no host verification), while 2 dots indicate TLS (strong security with host verification via certificates), and 3 dots indicate NLA (Network Level Authentication) which is the highest supported security method of RDP.

The black text shows the label of the bookmark, which defaults to the computer name, but can be changed to any text. Directly below, the bookmark will show the credentials, which will be used for the connections. If no credentials have been set a logon screen will appear when trying to connect.

Manage Bookmarks

Create/edit a Bookmark

If you want to create a new bookmark click the respective button at the top of the connection center or use the shortcut Command + N.

In case you want to edit a bookmark select it before you click the respective button at the top of the connection center or use the shortcut Command + E.

The following dialog opens:

In the General tab specify the connection settings.

First you need to set the host settings which is the computer you want to connect to:

  • Label: The name of the bookmark in the connection center. This can by any string. If you leave the field empty, it will be set to the hostname.
  • Host: The name of the computer you want to connect to. This can be a Windows computer name, an Internet domain name or an IP address.
  • Port:: The port to connect to. The default port for RDP is 3389. We recommend to not change this setting.

Next set the credentials (Username, password, domain). If those are left empty a dialog opens when starting the connection to enter them.

The Auto Reconnect feature allows iTap mobile RDP to reconnect to known sessions. You can return to the exact place you left a session. Change the timeout for automatic reconnect tokens. Reduce this if you have security concerns about automatic reconnect.

The Security Level is visualized in the bookmark list by this icon . As mentioned earlier the dots next to the icon indicate the security level:

  • 1 dot indicates basic security up to 140 bit FIPS compliant but no host verification
  • 2 dots indicate TLS which means strong security with host verification via certificates
  • 3 dots indicate NLA (Network Level Authentication) which is the highest supported security method of RDP

The Connection Test is enabled by default and informs about the health of the connection to the server or computer. If enabled, the following statuses appear with following icons:

  • Connection available:
  • Searching:
  • Connection issue:

If disabled a grey question mark is visible next to the bookmark label in the Connection Center.

If required you can set-up a Gateway by clicking the icon next to the drop down menu .

NOTE: This is possible in the main mask of the connection center by clicking the preferences button as well. For details see chapter Setting up a Gateway.

Screen Settings

Within the Screen settings are able to choose the resolution and color profile. You can set them for each bookmark seperately. Furthermore you can select:

  • Use all Monitors: Enable in case you have one or more monitors connected which you would like to make use of.
  • Fullscreen: Each session will start in fullscreen mode. Initially set on bookmark creation.
  • Scaling Content: Enables aspect ratio fixed scaling/resizing of the session content.

The miscellaneous settings may affect the performance of the RDP session:

  • Draw Desktop Wallpaper: If enabled, the user’s wallpaper is allowed on the remote computer.
    NOTE: a wallpaper can help prevent getting lost on a big desktop, but uses more bandwidth than a single color background.
  • Full-Window Drag: If enabled, the window contents are drawn while moving or resizing a window inside a session, if disabled only a frame is shown.
  • Menu Animations: If enabled, menu animations like fade in or expand are activated.
  • Use Windows Themes: If enabled, the Windows themes are drawn. If disabled the looks are like in Windows 2000 (=Classic mode).
  • Font Smoothing: If enabled, allows Windows to antialias (smooth) texts to improve readability automatically.
  • Desktop Effects: If enabled, Windows may use advanced desktop effects like crossfades or transparent windows. This greatly increases the bandwidth necessary.

Session Settings

This dialog summarizes the following set of features:

  • Set keyboard locale: Specifies the keyboard locale used in a session. (Default: System Keyboard Locale)
  • Set sound options: Select if sound should be played locally (default), on the server or turned off.
    NOTE: Together with the Windows server the client takes care of selecting appropriate compression automatically so that the audio adapts to the available bandwidth. Due to the compression, the audio quality will be diminished.
  • Connect to console session: This is a feature for administrators connecting to the console session on Windows Server 2003 and later versions.
  • Forward printing devices: All locally installed printers are being forwarded to the remote session.
  • Remote Program: This functionality is only available on Windows Terminal Server editions. Set a program to execute when you log on to a remote computer. You must specify the full path. When you specify a remote program you will not see a normal desktop instead the remote program will be launched fullscreen.

Folder Redirection

The folder redirection allows you to access local folders within the remote session. It is enabled by default as you can see in the screenshot below.

Initially no folder is chosen. In order to make use of this feature you need to select a folder yourself which will be mapped on your remote computer or server.

Click the icon below the list . Next choose the “Folder path” and enter a name for this folder.

Finally you should see the selected folder in the list which appeared empty before. When connected to your Windows PC or server you will find the folder as a mapped network drive under “My Computer”. The “Alias” will be reflected in the folder name as well as the name of your host device.
If you want to modify the “Alias” or “Path” of an existing redirected folder you need to select the item in the list and click this icon . To an existing redirected folder select the item and click this icon .

Please note following limitations:

  • When connecting to an already running RDP session with a different color depth, you may not get the new color depth. This behavior is server and Windows version dependent.
  • Automatic login may be disabled by the server, so even when you store your password it can happen that you still have to enter it.
  • The server may refuse a specific resolution and give you a different resolution instead.
  • The performance flags are just recommendations to the server. A server may disregard them due to server policy, missing support or other reasons.

Export Existing Bookmarks

In order to export existing bookmarks first select the respective item(s). Holding down the shift button enables you to select multiple bookmarks. Next use the secondary/right click and select “Export” or use “File” → “Export bookmark” via the menu bar.

Then the directory chooser dialog opens and helps you with selecting the destination path for saving the bookmark(s). Optionally you can export the bookmarks with passwords.

When done each bookmark will be saved as separate file: label.rdp

NOTE: When exporting just one bookmark a filename needs to be given.

Import Bookmarks

In order to import bookmarks choose in the menu bar: file → import bookmark. Next choose the path where you have stored your bookmarks (hold shift when selecting more than one).

Delete Bookmarks

If you would like to delete a bookmark just right click the respective bookmark and choose "Delete" in the menu. You may as well use the delete key on your keyboard.

Global Preferences

Setting up a Gateway

You can set-up a gateway buy clicking the preferences button in the connection center or when add/edit a bookmark. A new window opens with a list of available gateways.
NOTE: Initially this list is empty.

To add a gateway click this symbol below the list. Afterwards enter all relevant information of the respective gateway. In case you do not need an existing gateway anymore choose it and click this button .

Advanced Settings

In the advanced settings you can add/delete standard resolutions. Those can be selected in the drop down menu within the screen settings, when editing or setting up a new bookmark.

To add (+) or delete (-) click the respective buttons below the list. In case you want to restore the defaults use the button at the bottom on the right.

Getting Connected

Start a Session

To connect to the host of your choice either select the bookmark and

  • use the shortcut Command + O
  • open per second click the menu and choose start
  • double click
  • use the start button in the toolbar above

Getting along in an RDP session on Mac

The session opens with all the options you have set within your bookmark settings previously (e.g.: resolution, remote program...). Now you may navigate through Windows by mouse or Windows shortcuts just as you would sitting in front of a local installation of Windows.

If you are in fullscreen mode the iTap mobile RDP menu bar at the top of the screen is hidden. Direct the mouse cursor to the top of the screen and the menu bar slides down. You may also activate commands with keyboard shortcuts (as stated next to the command's caption). A complete list of application shortcuts for Mac is included in the appendix.

Please note that the Mac keyboard layouts differ from the Windows keyboard layouts. The keyboard locale, set in iTap mobile RDP bookmark settings, is suggested to the server. When the setting is set to “System Keyboard Locale” and your current local keyboard is not under the iTap mobile RDP’s manual selectable options your OS locale might be ignored by the server. In this case we recommend checking the keyboard setting on your server and changing it manually.

The section Keyboard mappings highlights the differences between the Mac and Windows keyboard layouts.

  • The Command key on the Mac keyboard equals the Windows key.
  • All actions, which you perform with the Command button on the Mac, you need to use the control button in Windows (e.g.: Copy = Ctrl + C).
  • The function keys can be activated in the session by pressing additionally the FN key (e.g.: FN + F1).
  • The Alt key right to the space bar on the Mac keyboard equals the Alt Gr/right Alt key in Windows.

Appendix

URL Scheme

iTap mobile RDP now supports opening special links in the Safari browser. As a normal user, you do not need to concern yourself with this feature, since it will work completely automatic. Just click an RDP link in Safari, and iTap mobile RDP will automatically open and connect to the given server.

If you are a systems integrator, or otherwise want to provide RDP links in your webpages, please see the URL scheme documentation on how to provide RDP links.

Application Shortcuts

Connection Center shortcuts:

  • Open Preferences: ⌘ ,
  • Hide iTap mobile RDP: ⌘ H
  • Hide Others: ⌘ ⌥ H
  • Quit iTap mobile RDP: ⌘ Q
  • New Bookmark: ⌘ N
  • Delete Bookmark*: Del or FN + Backspace
  • Edit Bookmark*: ⌘ E
  • Find Bookmark: ⌘ F
  • Start Bookmark*: ⌘ O

*NOTE: Respective Bookmark needs to be selected first.

The following application shortcuts are available in an active session:

  • Toggle fullscreen: ⌘ 1
  • Toggle scaling: ⌘ 2
  • Close window: ⌘ W
  • Quit iTap mobile RDP: ⌘ Q

Keyboard Mappings

This guide addresses users working on a mac keyboard when connected to a Windows PC or server. It helps to find characters which are positioned on a Windows keyboard differently.

Important notice: Keyboard language on the host must match language on the client.

Dutch (Netherlands)

Windows Character Mac keyboard shortcut
@ §
/ -
° =
¨ [
* ]
+ ;
´ '
< \
- /
] `
¬ right alt + §
¹ right alt + 1
² right alt + 2
³ right alt + 3
¼ right alt + 4
½ right alt + 5
¾ right alt + 6
£ right alt + 7
{ right alt + 8
} right alt + 9
\ right alt + -
¸ right alt + =
right alt + E
right alt + R
ß right alt + S
¦ right alt + `
« right alt + Z
» right alt + X
¢ right alt + C
µ right alt + M
· right alt + .
§ ⇧ §
" ⇧ 2
& ⇧ 6
_ ⇧ 7
( ⇧ 8
) ⇧ 9
' ⇧ 0
? ⇧ -
~ ⇧ =
± ⇧ ;
` ⇧ '
> ⇧ \
[ ⇧ `
; ⇧ ,
: ⇧ .
= ⇧ /

English (Australia)

Windows Character Mac keyboard shortcut
` §
\ `
~ ⇧ §
| ⇧ `

English (UK)

Windows Character Mac keyboard shortcut
` §
# \
\ `
¦ right alt + §
right alt + 4
é, ú, í, ó, á right alt + E, U, I, O, A
¬ ⇧ §
" ⇧ 2
@ ⇧ '
~ ⇧ \
| ⇧ `

English (USA)

Windows Character Mac keyboard shortcut
` §
\ `
~ ⇧ §
| ⇧ `

Finnish (Finland)

Windows Character Mac keyboard shortcut
@ right alt + 2
£ right alt + 3
$ right alt + 4
right alt + 5
{ right alt + 7
[ right alt + 8
] right alt + 9
} right alt + 0
´ right alt + ´
right alt + E
~ right alt + ¨
µ right alt + M
½ ⇧ §

French (Belgium)

Windows Character Mac keyboard shortcut
² @
µ `
| right alt + &
@ right alt + é
# right alt + "
{ right alt + '
[ right alt + (
^ right alt + §
{ right alt + ç
} right alt + à
right alt + E
[ right alt + ^
] right alt + $
´ right alt + ù
` right alt + `
\ right alt + <
~ right alt + =
³ ⇧ @

French (Canada)

Windows Character Mac keyboard shortcut
` /
[ ^
]
ç
' è
\ à
\ ù
~ ⇧ /
^ ⇧ 6
{ ⇧ ^
} ⇧ Ç
" ⇧ È
| ⇧ À
| ⇧ Ù
< ⇧ ,
> ⇧ .
? ⇧ é

French (France)

Windows Character Mac keyboard shortcut
² @
- §
_ !
= -
* `
! =
~ right alt + é
# right alt + "
{ right alt + '
[ right alt + (
| right alt + §
` right alt + è
\ right alt + !
^ right alt + ç
@ right alt + à
] right alt + )
} right alt + -
right alt + E
+ ⇧ -
£ ⇧ $
µ ⇧ `
§ ⇧ =

German (Germany)

Windows Character Mac keyboard shortcut
² right alt + 2
³ right alt + 3
{ right alt + 7
[ right alt + 8
] right alt + 9
} right alt + 0
\ right alt + -
@ right alt + Q
right alt + E
~ right alt + +
| right alt + <
µ right alt + M

Greek (Greece)

Windows Character Mac keyboard shortcut
` §
< `
² right alt + 2
³ right alt + 3
£ right alt + 4
§ right alt + 5
right alt + 6
¦ right alt + 9
° right alt + 0
± right alt + -
½ right alt + =
right alt + Ε
® right alt + Ρ
¥ right alt + Υ
« right alt + [
» right alt + ]
΅ right alt + ΄
¬ right alt + \
© right alt + Ψ
~ ⇧ §

Italian (Italy)

Windows Character Mac keyboard shortcut
right alt + E
[ right alt + è
] right alt + +
@ right alt + ò
# right alt + à

Norwegian (Norway)

Windows Character Mac keyboard shortcut
| '
\ ´
' @
@ right alt + 2
£ right alt + 3
$ right alt + 4
right alt + 5
{ right alt + 7
[ right alt + 8
] right alt + 9
} right alt + 0
´ right alt + ´
right alt + E
~ right alt + ¨
µ right alt + M
§ ⇧ '

Romanian (Romania)

Windows Character Mac keyboard shortcut
ș
î â
ș ;
ț '
â ț
\ î
` right alt + ș
~ right alt + 1
ˇ right alt + 2
^ right alt + 3
˘ right alt + 4
° right alt + 5
˛ right alt + 6
` right alt + 7
˙ right alt + 8
´ right alt + 9
˝ right alt + 0
¨ right alt + -
¸ right alt + =
right alt + E
§ right alt + P
[ right alt + Ă
] right alt + Â
ß right alt + S
đ right alt + D
ł right alt + L
; right alt + ;
' right alt +'
\ right alt + Ț
© right alt + C
< right alt + ,
> right alt + .
⇧ ș
Î ⇧ Â
Ș ⇧ ;
Ț ⇧ '
| ⇧ Î
; ⇧ ,
: ⇧ .

Russian (Russia)

Windows Character Mac keyboard shortcut
ё >
\ ё
\ ]
. /
Ё ⇧ >
; ⇧ 4
% ⇧ 5
: ⇧ 6
? ⇧ 7
* ⇧ 8
/ ⇧ Ё
, ⇧ /

Spanish (Spain)

Windows Character Mac keyboard shortcut
º [
' -
¡ =
` ´
+ `
´ ;
ç '
- ç
\ right alt + [
| right alt + 1
@ right alt + 2
# right alt + 3
~ right alt + 4
right alt + 5
¬ right alt + 6
right alt + E
[ right alt + ´
] right alt + `
{ right alt + ;
} right alt + '
ª ⇧ [
! ⇧ 1
" ⇧ 2
· ⇧ 3
& ⇧ 6
/ ⇧ 7
( ⇧ 8
) ⇧ 9
= ⇧ 0
? ⇧ -
¿ ⇧ =
^ ⇧ ´
* ⇧ `
¨ ⇧ ;
Ç ⇧ '
; ⇧ ,
: ⇧ .
_ ⇧ ç

Swedish (Sweden)

Windows Character Mac keyboard shortcut
@ right alt + 2
£ right alt + 3
$ right alt + 4
right alt + 5
{ right alt + 7
[ right alt + 8
] right alt + 9
} right alt + 0
\ right alt + +
right alt + E
~ right alt + ¨
| right alt + <
µ right alt + M
½ ⇧ §