# Thinlinc

- For login, check your [MFA](https://wiki.math.uzh.ch/public/books/public-wiki/chapter/mfa)

## Cheat Sheet

<table id="bkmrk-actionnote-disconnec" style="width: 100%; border-collapse: collapse;"><thead><tr><th scope="col">Action</th><th scope="col">Note</th></tr></thead><tbody><tr><td>Disconnect Session</td><td>Press  **'F8'** &gt; 'Disconnect'</td></tr><tr><td>Screen Lock</td><td>Activate: **Ctrl - Alt - L**,  
Unlock: to display password prompt, press any key or move the mouse. Sometimes it's necessary to press **Esc** two times.</td></tr><tr><td>[USB Stick](https://wiki.math.uzh.ch/public/link/188#bkmrk-usb-sticks%3A-terminal)</td><td>**~/thindrives**</td></tr><tr><td>[Local files](https://wiki.math.uzh.ch/public/link/188#bkmrk-copy-files-from%2Fto-t)</td><td>**~/thindrives**</td></tr><tr><td>Screen Size</td><td>Press 'F8' &gt; 'Fullscreen: Disable' to make a fullscreen Window resizable.  
This is also useful at the I-MATH Terminals, if the screen size does not fit perfectly to the monitor (deactivate and then activate the fullscreen mode again).</td></tr><tr><td>[Keyboard Layout](https://wiki.math.uzh.ch/public/link/188#bkmrk-keyboard-layout)</td><td>The keyboard will be automatically detected during log in. If you need special characters, the easiest way is to use the 'Compose Key'</td></tr><tr><td>[Install Thinlinc](https://drive.math.uzh.ch/index.php/s/B76tQxrwgGyQobj) (Video)</td><td>Installation of thinlinc client.</td></tr><tr><td>Ctrl-Alt-Esc</td><td>Restart cinnamon window manager</td></tr></tbody></table>

- Accessing the **same** session **locally** (at the institute) and **remotely** (for example at home) - no hassle anymore with locked Firefox profiles.
- **IT Support**: on your request, it is possible to 'shadow' your session to the IT group - in case of any trouble - **just call the IT by phone**.

## Connect Session

- Use any of the Terminals at the institute or use the 'native client' (see below) application on your own computer (Internet access is needed).
- Just login. 
    - An already existing session (in the background or on another terminal) will be moved and reconnect you.
- Server: **tl.math.uzh.ch**

[![tlclient.png](https://wiki.math.uzh.ch/public/uploads/images/gallery/2026-06/tlclient.png)](https://wiki.math.uzh.ch/public/uploads/images/gallery/2026-06/tlclient.png)

- By default, the Session is **fullscreen**. To change this, open the 'popup menu' by pressing F8 and change **Full screen**.

## Disconnect Session

- **Press F8** to open 'popup menu' and choose **disconnect**. 
    - If you need the 'F8 key' in an application, assign another key for the popup menu. To do so: `F8 > Options > Options > Popup Menu Key`. The new setting is only active during the recent connected session.

## Get a new and fresh session

Sometimes it happens that your session is locked for some reason (crashed apps, quota problem, ...). A session disconnect / reconnect does not improve the situation.

Please check the option **End existing session** in the `tlclient` login window and log in again. Your old session will be killed and a new session will be created. All open applications will be terminated. Open files might be lost. Use is with caution!

[![tl.end.existing.session.png](https://wiki.math.uzh.ch/public/uploads/images/gallery/2026-06/tl-end-existing-session.png)](https://wiki.math.uzh.ch/public/uploads/images/gallery/2026-06/tl-end-existing-session.png)

- This option is not available via Webaccess.

## USB sticks: Terminals in building Y27

- If you plug in a USB Stick at the terminal, there is **no window**, which opens automatically.
- Plugged in USB sticks or ext. hard drives will appear in your home directory under the folder **thindrives**.
- Open a Filemanager (Menu: Places) and navigate to your 'home directory &gt; thindrives'.
- Mount and unmount happens automatically - wait a few seconds.
- If you copy data, wait until the light on the USB stick **stops** flashing or the **progress bar** disappear, plus some additional seconds. After that, it's secure to remove the stick.
- If the stick does not appear under directory '~/thindrives', please trigger a remount via menu **Repair thindrives (USB Stick , ...)**.

## Remote Access: thinlinc@home

### By webbrowser

- [https://tl.math.uzh.ch](https://tl.math.uzh.ch)
- No sound.
- No local drives
- For touch based devices (Tablets), you'll find a software keyboard on the top of the window,

### By native client

- Install the native Client (Linux, Windows, Mac): [Download](http://www.cendio.com/downloads/clients/)
    - At the moment, there is no native Android, Windows Phone or iOS support. Use the webclient instead.

\* Start the native client and connect to:

```

tl.math.uzh.ch

```

- Be aware, the second character of the servername is a lowercase 'L'!

- Username / Password: as your I-MATH Account.

- It is possible that you have to accept the **hostkey**: press 'Continue'

[![hostkey.png](https://wiki.math.uzh.ch/public/uploads/images/gallery/2026-06/hostkey.png)](https://wiki.math.uzh.ch/public/uploads/images/gallery/2026-06/hostkey.png)

- **Disconnect** / toggle **Full screen**: Pressing 'F8' opens a menu, with options for: 
    - **Disconnect**.
    - changing **Full Screen**.
- Best practice: it's not necessary to log out, just disconnect.

### Printing at home

- Choose Thinlocal as Printer 
    - It automatically uses your default printer configured on your PC/Laptop at home

[![printthinlocal.jpg](https://wiki.math.uzh.ch/public/uploads/images/gallery/2026-06/printthinlocal.jpg)](https://wiki.math.uzh.ch/public/uploads/images/gallery/2026-06/printthinlocal.jpg)

### Copy files from/to the Thinlinc Session

- On your own computer: 
    1. Open the 'Native Thinlinc Client' on your computer and choose **Options &gt; Local Devices &gt; Drives: Details**
    2. Create a mapping: add a new directory and set **permissions**.

[![thinlinc.options.local.drives.png](https://wiki.math.uzh.ch/public/uploads/images/gallery/2026-06/thinlinc-options-local-drives.png)](https://wiki.math.uzh.ch/public/uploads/images/gallery/2026-06/thinlinc-options-local-drives.png)

[![thinlinc.export.local.png](https://wiki.math.uzh.ch/public/uploads/images/gallery/2026-06/thinlinc-export-local.png)](https://wiki.math.uzh.ch/public/uploads/images/gallery/2026-06/thinlinc-export-local.png)

[![thinlinc.select.png](https://wiki.math.uzh.ch/public/uploads/images/gallery/2026-06/thinlinc-select.png)](https://wiki.math.uzh.ch/public/uploads/images/gallery/2026-06/thinlinc-select.png)

- Thinlinc Session 
    - Via the native client from above, **Login** to the thinlinc session.
    - Open the file manager (lower left corner: Menu, type 'files') and navigate to **thindrives** inside your home directory.
- Hint: If there are **troubles** with a mapped directory (e.g. broken 'thindrives' directory in your thinlinc session), choose in the thinlinc session in the menu **Repair thindrives (USB Stick , ...)**.

## Dropbox

You can also use dropbox or switchdrive to copy data to the thinlinc session.

- [Dropbox](https://wiki.math.uzh.ch/public/books/public-wiki/page/dropbox)

## Keyboard Layout

- A quick solution, to type characters not directly accessible on the keyboard, is by using the 'compose key' - please check [ComposeKey](https://wiki.math.uzh.ch/public/books/public-wiki/page/composekey).
- **Select keyboard layout**: 
    - The Keyboard layout is stored on the terminal.
    - If you move to a different terminal, you have to select the keyboard again.
    - Before you connect to a thinlinc session (or if you are already logged into thinlinc: press F8 and uncheck 'Full screen'), select on the lower left corner:

`Keyboard > Keyboard Layout: Edit ...`

- Website to convert keystrokes to specific languages: [http://www.typeit.org/](http://www.typeit.org/)

## WebCam: MS-Teams / Zoom / Skype / SeminarLive

- Webcams are only **supported** on the terminals, installed at the **institute**!
- Audio/Video **Test**: [https://janus.conf.meetecho.com/echotest.html](https://janus.conf.meetecho.com/echotest.html) (press 'Start' on the top)
- Webcam Support: 
    - Terminal in Y27: **plug in the webcam**.
    - Personal laptop: **NO** webcam support. Please start your !VideoCall outside of the Thinlinc session.
- You can borrow a webcam and/or a headset from [Support](http://math.uzh.ch/support).
- The Camera will not be available if you are already using it in another application (only one Application can access it at a time)
- When the camera is on, there is a green light on the left side of the lense.

[![cam.png](https://wiki.math.uzh.ch/public/uploads/images/gallery/2026-06/cam.png)](https://wiki.math.uzh.ch/public/uploads/images/gallery/2026-06/cam.png)

### Video

- [https://webcammictest.com/](https://webcammictest.com/)
- (Check) If your camera is not recognized by the application, open a terminal and enter `tlwebcam-ctl list-cameras`, to make sure the camera is connected in the first place. There needs to be at least one camera listed.

[![listcams.png](https://wiki.math.uzh.ch/public/uploads/images/gallery/2026-06/listcams.png)](https://wiki.math.uzh.ch/public/uploads/images/gallery/2026-06/listcams.png)

- (Fix 1) If broken: Disconnect (`F8 > Disconnect`) Thinlinc Session and log in again. Reload the browser page.
- (Fix 2) Power the terminal off and on . Connect again to the Thinlinc session. Reload the browser page.
- (Fix 3) If the cameras' light isn't on and the camera doesn't display anything in your VideoMeeting/Recording, enter `tlwebcam-reload` in the Terminal, to reload the service completely.

### Audio

- Audio redirection only works with the `native client` - **not** with the thinlinc **browser** version. 
    - Tablet: There is no sound redirecting, because there is no native client.

#### Fix Problem

- [https://webcammictest.com/mic/](https://webcammictest.com/mic/)
- **Check:** If there is no sound at all (verify by playing a youtube video), check the 'Audio redirection' via `Pulse Audio Volume Control`
    - ok: Output: **Tunnel to 127.0.0.1:5...**
    - broken: Output: **Dummy output**

[![pa1.png](https://wiki.math.uzh.ch/public/uploads/images/gallery/2026-06/pa1.png)](https://wiki.math.uzh.ch/public/uploads/images/gallery/2026-06/pa1.png)

[![pa2.png](https://wiki.math.uzh.ch/public/uploads/images/gallery/2026-06/pa2.png)](https://wiki.math.uzh.ch/public/uploads/images/gallery/2026-06/pa2.png)

- **Fix 1:** If broken: Disconnect (`F8 > Disconnect`) Thinlinc Session and log in again. Wait 5 seonds, 'Dummy...' should be replaced by 'Tunnel...'. This fixes the majority of audio issues!
- **Fix 2:** Audio / Mic is not working - do the following steps, exact in the given order: 
    - `F8 > Session disconnect` and than login again.
    - **Unplug** the USB Headset, wait 3 seconds and **plug in** again.
    - If the System is using the wrong Audio Device or Microphone, unplug and plug again the **desired** device.
- **Fix 3:** If still 'Dummy...' appears (see 'Check'), `Logout' completely (Menu &gt; Logout) and log in again. If this is often necessary (more than once a month), contact [Support](http://math.uzh.ch/support).

## Cinnamon

### Applet

- Overview over all available applets: [https://cinnamon-spices.linuxmint.com/applets](https://cinnamon-spices.linuxmint.com/applets)

Installation:

- Menu &gt; Settings &gt; Applets &gt; Download (wait 10 seconds until the list is updated)

[![applet1.png](https://wiki.math.uzh.ch/public/uploads/images/gallery/2026-06/applet1.png)](https://wiki.math.uzh.ch/public/uploads/images/gallery/2026-06/applet1.png)

- Download the wished app.
- Switch to 'Manage' and activate (click on '+') the applet

[![applet2.png](https://wiki.math.uzh.ch/public/uploads/images/gallery/2026-06/applet2.png)](https://wiki.math.uzh.ch/public/uploads/images/gallery/2026-06/applet2.png)

### Extension

[![cinnamon-extension.png](https://wiki.math.uzh.ch/public/uploads/images/gallery/2026-06/cinnamon-extension.png)](https://wiki.math.uzh.ch/public/uploads/images/gallery/2026-06/cinnamon-extension.png)

## Filemanager: Nemo

- 15 nice tweaks: [https://itsfoss.com/nemo-tweaks/](https://itsfoss.com/nemo-tweaks/)

## Setting Default Printer

- Menu &gt; Printers &gt; right click (over printer) &gt; Set Default Printer &gt; Set as my personal default printer.

[![printer-default.png](https://wiki.math.uzh.ch/public/uploads/images/gallery/2026-06/printer-default.png)](https://wiki.math.uzh.ch/public/uploads/images/gallery/2026-06/printer-default.png)

If `Set Default Printer` is disabled

- Open the printer via panel notification applet (lower right corner) &gt; .
- After that, repeat the first step.
- If there is no printer applet in the lower right corner: 
    - Menu &gt; System Settings &gt; Applets &gt; Manage &gt; Printers &gt; Settings &gt; Show printer icon: When printers exist

[![printer-applet.png](https://wiki.math.uzh.ch/public/uploads/images/gallery/2026-06/printer-applet.png)](https://wiki.math.uzh.ch/public/uploads/images/gallery/2026-06/printer-applet.png)

## Multi-Head Support

- Fully supported via native client.
- Mac OS X: "macOS (formerly OS X) versions newer than 10.9 installs 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."

### Primary / Secondary Display

- In a multi head setup, one screen becomes the primary screen.
- Typically, on the primary screen is the menu bar.
- Most people prefore the left screen as primary. This can be configured.
- Sometimes a computer (lthinstations in the institute) detects the connected screens in a different order, and than suddenly the primay screen is on the wrong side.

How to fix / change primary sceen:

- **Disconnect** from thinlinc session.
- Open the screen setup on your computer. 
    - On thinstation (computer at the institute): Menu &gt; Configuration &gt; Display Properties

[![multihead-primary.png](https://wiki.math.uzh.ch/public/uploads/images/gallery/2026-06/multihead-primary.png)](https://wiki.math.uzh.ch/public/uploads/images/gallery/2026-06/multihead-primary.png)

- Login to thinlinc

## FAQ

- Q: The native client does not work 
    - A: Please always use the latest version: [https://www.cendio.com/thinlinc/download](https://www.cendio.com/thinlinc/download)
- Q: Thinlinc via Webbrowser - clipboard is not working 
    - Known limitation by using thinlinc in webbrowser - if possible use the native client.
    - Work around: open the menu on the left side &gt; clipboard. Insert the clipboard, mark it, and copy it again to the clipboard - now it should be available via clipboard in any application.

[![web-clipboard.png](https://wiki.math.uzh.ch/public/uploads/images/gallery/2026-06/web-clipboard.png)](https://wiki.math.uzh.ch/public/uploads/images/gallery/2026-06/web-clipboard.png)