# macOS

## Requirements

- macOS (formerly OS X) version newer than 10.6 running on 64-bit Intel hardware

Note

macOS (formerly OS X) versions newer than 10.9 comes with a default setting that breaks the multi monitor functionality of the ThinLinc client. A workaround to this problem is to disable setting Displays have separate Spaces in settings for Mission Control found in System Preferences.

## Installing the macOS client

The client for macOS can be found in the directory `client-macos` in the client bundle. To install the client, follow these steps:

1. Double-click on the file `tl-x.y.z_rel-client-macos.dmg`.

2. Drag the ThinLinc client application to an application folder of your choice.

3. Eject the ThinLinc client volume.

## Running the macOS client

To start the ThinLinc client, double-click on the client application. The client can also be added to and started from the Dock.

## Command and Alt keys on macOS

The `Alt` key (also known as the `Option` key) behaves very differently on macOS compared to its behavior on other platforms. It closely resembles the PC `AltGr` key, found on international keyboards. ThinLinc therefore treats these keys in a special manner on macOS in order to provide a good integration between the client and the remote ThinLinc system.

Whenever either of the `Alt` keys are pressed, ThinLinc will behave as if `AltGr` was pressed. The left `Command` key is used as a replacement for `Alt` to use shortcuts like ``Alt`+`F``. The right `Command` key retains its behavior of acting like the `Super`/`Windows` key.