.. meta::
   :description: Instructions for installing and running the ThinLinc
                 client on macOS, including system requirements,
                 installation steps, and key behavior customization for
                 Command and Alt keys.

.. _macosclients:

macOS
-----

.. _macosclientsreq:

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
   :guilabel:`Displays have separate Spaces` in settings for
   :guilabel:`Mission Control` found in :guilabel:`System Preferences`.

.. _macosclientsinstall:

Installing the macOS client
~~~~~~~~~~~~~~~~~~~~~~~~~~~

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

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

2. Double-click on the :guilabel:`ThinLinc client` volume that just
   appeared on your desktop.

3. Drag the :guilabel:`ThinLinc client` application to an application
   folder of your choice.

4. Eject the :guilabel:`ThinLinc client` volume.

.. _macosclientsrun:

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.

.. _macosalt:

Command and Alt keys on macOS
~~~~~~~~~~~~~~~~~~~~~~~~~~~~~

The :kbd:`Alt` key (also known as the :kbd:`Option` key) behaves very
differently on macOS compared to its behavior on other platforms. It
closely resembles the PC :kbd:`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 :kbd:`Alt` keys are pressed, ThinLinc will behave
as if :kbd:`AltGr` was pressed. The left :kbd:`Command` key is used as
a replacement for :kbd:`Alt` to use shortcuts like :kbd:`Alt+F`. The
right :kbd:`Command` key retains its behavior of acting like the
:kbd:`Super`/:kbd:`Windows` key.