Thincast Client allows you to access and manage all your virtualized desktops running on Thincast Workstation. It's completely free and available for Windows, Linux and macOS.
Thincast Client is currently in Beta phase, see "Versions" below.
We do provide different versions:
- Stable - Official releases. Use this for production.
- Beta - Upcoming release. Beta versions are under qualification testing, and may include significant issues.
- Nightly - Development snapshot. Contains the latest features and improvements but isn't completely tested and may include severe issues.
The beta and nightly versions are mainly for preview and evaluation purposes. Don't use them in production!
It is the end users' responsibility to protect their systems and data when using such beta/nightly software. It is strongly recommended that end users do back up all their data prior to using beta/nightly software.
Beta and nightly software does neither carry any warranties nor support services.
Systems that run Thincast Client must meet specific requirements:
Supported Operating Systems
- Windows 7 / 8 / 8.1 / 10
- Windows Server 2008 R2 / 2012 / 2012 R2 / 2012
Thincast Client does support x86 and x64 environments.
- macOS 10.10 or later is supported
- Ubuntu 16.04 (xenial) / 18.04 (bionic) / 18.10 (cosmic) / 19.04 (disco)
- Debian 9 (stretch) / unstable (sid) * Debian 9 (stretch) / testing (buster) / unstable (sid)
- OpenSUSE 42.3 * OpenSUSE 15.0
- Fedora 27 * Fedora 27
To use the advantage of hardware video decoding, your GPU must support at least DirectX version 9.0c. However, the GPU software drivers must support DirectX 11 Feature Level 9.1 (which means the DirectX 11 API has been implemented in the GPU software driver to be compatible with DirectX 9 hardware). The following list shows supported GPUs but is subject to driver support for your operating system:
- Nvidia Geforce 8 Series or higher
- AMD HD 2000 Series or higher
- Intel HD Graphics Sandy Bridge generation or higher
Please note that hardware acceleration might not be available for Linux.
Thincast Client requires a properly configured network to communicate with the Thincast Workstation.
Thincast Client supports multiple platforms, please refer to chapter "Supported operating systems". Please also make sure that you have installed all recent operating system and driver updates.
- Download the latest version of Thincast Client for Windows from here.
- Open the installation package.
- Thincast Client Setup will now be opened. Continue with "Next".
- Accept the End-user License Agreement and proceed with "Next".
- Select the destination folder for Thincast Client and click "Next".
- Choose the shortcut options you wish and continue with "Next".
- Click "Install" to begin the installation. Accept the dialog with "Yes".
- Click "Finish" to complete your installation.
If no shortcut was created, Thincast Client can be found under:
- Download the latest version of Thincast Client for macOS from here.
- Double-click the .dmg file to mount it and click on "Agree".
- Drag and drop the application onto the shown shortcut icon "Applications".
- Close the Window.
- Eject the disc image in Finder.
- Delete the .dmg file by dragging it to the trash.
- You've now installed Thincast Client for macOS. The application is inside your Applications folder.
The Linux version of the Thincast Client uses the package management of the respective distribution. You find the installed files in "/opt/thincast". The client itself can be found in "/opt/thincast/bin/" and is called "TCClient".
Ubuntu and Debian
First install the repository signing key:
wget -O - https://www.thincast.com/download/50A50847305E8C67.asc | sudo apt-key add -
In the following instructions replace "stretch" with the code name of your Debian/Ubuntu distribution. Available Distributions:
Debian: stretch (9), buster(testing), sid (unstable) Ubuntu: xenial (16.04), bionic (18.04), cosmic (18.10), 19.04 (disco)
The URLs can also be used via https if the corresponding apt transport is installed:
apt-get install apt-transport-https
To install and get updates for the Thincast client, a sources list must be added to your system. Create the file "/etc/apt/sources.list.d/thincast-client.list" with the following content:
- for the beta versions
deb http://www.thincast.com/software/download/tcc/beta/linux-stretch/ thincast-client-beta main
- for nightly versions
deb http://www.thincast.com/software/download/tcc/nightly/linux-stretch/ thincast-client-nightly main
After creating the sources list file run:
apt-get update apt-get install thincast-client
Available for OpenSUSE 15.0
Depending on the version you want to use, add a new the repository by creating the file "/etc/zypp/repos.d/thincast-client.repo" with the following content:
- beta version
[thincast-client] name=thincast-client baseurl=https://www.thincast.com/software/download/tcc/beta/linux-sl15.0 enabled=1 autorefresh=1 type=rpm-md gpgcheck=0 keeppackages=0
- nightly version
[thincast-client] name=thincast-client baseurl=https://www.thincast.com/software/download/tcc/nightly/linux-sl15.0 enabled=1 autorefresh=1 type=rpm-md gpgcheck=0 keeppackages=0
After the file was created, run these commands to install the Thincast Client:
zypper refresh zypper install thincast-client
Available for Fedora 28 and 29.
Depending on the version you want to use, add a new the repository by creating the file "/etc/yum.repos.d/thincast-client.repo" with the following content:
- beta version
[thincast-client] name=thincast-client baseurl=http://www.thincast.com/software/download/tcc/beta/linux-fedora-$releasever/ enabled=1 metadata_expire=12h gpgcheck=0
- nightly version
[thincast-client] name=thincast-client baseurl=http://www.thincast.com/software/download/tcc/nightly/linux-fedora-$releasever/ enabled=1 metadata_expire=12h gpgcheck=0
After the file was created, run these commands to install the Thincast Client:
dnf refresh dnf install thincast-client
- To uninstall Thincast Client, open your Control Panel and navigate to Programs -> Uninstall a program.
- Right-click on Thincast Client and select Uninstall.
- Confirm with Yes.
- You've now successfully uninstalled Thincast Workstation.
- Quit Thincast Client.
- Open your Applications folder and drag the Thincast Client icon into the Trash.
- Empty the Trash.
- You've now successfully removed Thincast Client.
apt-get remove thincast-client
zypper remove thincast-client
dnf remove thincast-client
After installation, you can start Thincast Client as follows:
- On a Windows system, just type "Thincast Client" in the search box of the "Start" menu.
- On macOS, open the Finder and double-click on the "Thincast Client" item in the "Applications" folder.
- On Linux either use the menu entry if your desktop environment has one or run "/opt/thincast/bin/TCClient" manually.
Thincast Client will launch and depending on your configuration it will automatically discover all available servers and machines from your network.
If no servers are available, please check your network configuration and verify that Thincast Workstation is running. To add a server manually just click on "Servers" in the menu bar and after that on "Add".
To access your virtualized desktop, simply double-click the specific VM in Thincast Client. A secured connection will be established and your virtualized desktop appears inside Thincast Viewer.
Note on Windows: For quick access, pin your virtualized desktop to your taskbar.
The user interface of Thincast Client is kept simple. On the top you'll find the menu bar and below a list of servers will be shown. After connecting to a specific machine, the virtualized desktop will appear inside Thincast Viewer, which is your "Remote Display".
The menu bar on the top allows you to quickly access all important tasks of Thincast Client:
Following actions are available in the menu bar:
|Add||Start||Start||Session Defaults||Check for updates|
|Convert to manual entry||ACPI Shutdown||ACPI Shutdown||Client Logging|
|Remove||Power down||Power down||Session Logging|
|Clear credentials||VM details||Log Directory|
|Connect||Create desktop shortcut||Server Auto-Discovery|
|Disconnect||Pin to taskbar|
Basic tasks to manage your servers:
Add - Add a new server manually. To add a server, enter the required fields and click on "OK". The server will now appear in the list.
Edit - Edit a selected server
Convert to manual entry - Convert an automatically discovered entry from the server list into a manual entry. Manual entries remain visible, even if the server is not available.
Remove - Remove a selected server. Note: A server cannot be removed while you're connected.
Clear credentials - Clear the saved credentials for a selected server.
Connect - Connect to a selected server. The user authentication window may appear.
Disconnect - Disconnect from a selected server.
Details - View server details. This gives you information about the used version of Thincast Workstation on the server.
Basic tasks to manage a selected machine:
Start - Start the selected machine.
Connect - Connect to the selected machine. Your virtualized desktop will now appear inside Thincast Viewer.
ACPI Shutdown - Shutdown the selected machine gracefully.
Power down - Abruptly cut off the power for the selected machine. Data corruption may occur!
VM details - Show ip address, port, operating system and GUID of the selected machine.
Create desktop shortcut - Create a desktop shortcut for the selected machine.
Pin to taskbar - Pin the selected machine to your taskbar.
Basic tasks for a group of machines. Note: Groups can only be configured in Thincast Workstation.
Start - Start a selected group of machines.
Connect - Connect to a selected group of machines.
ACPI Shutdown - Shutdown the selected group gracefully.
Power down - Abruptly cut off the power for the selected group. Data corruption may occur!
Session Defaults - Set default options for session handling:
- Autostart VM (When selected, machine starts automatically after connecting)
- Ignore Unknown Certificate (Ignore warning dialogs if a certificate is unknown or not valid)
- Strict Certificate Validation (The verification of the certificate is strict. If the check failed, a connection to the selected machine is not possible.)
- Trust Certificate on first use (After trusting a certificate once, you'll not get any further warnings regarding this certificate.)
- Clear Certificate Cache (Deletes the store containing all previously trusted certificates.)
- Use FQDN (Use the complete domain name for a specific machine)
- Clipboard (Enables the clipboard by default)
- Sound Settings (Play sound on the local computer, on the remote computer or do not play sound at all.)
- Microphone (Enable/Disable the use of a microphone.)
Update Settings - Enable or disable automatic update for Thincast Client (not available on Linux as the package(s) will be updated along with your distributions packages).
You'll get notified when a new version of Thincast Client has been released.
You can also switch between the available update channels for Thincast Client:
- Stable releases - Choose this, if you only wish to be notified about stable updates to Thincast Client
- Stable and Beta releases - Choose this to be notified about stable and beta updates to Thincast Client
- Stable, Beta and Nightly releases - Choose this to be notified about stable, beta and nightly updates to Thincast Client . Note: Nightly updates might be unstable!
Client Logging - Enable client debug logging
Session Logging - Enable session debug logging
Log Directory - Specifies the directory where client/session log files will be stored.
Default locations if this option is not set:
Server Auto-Discovery - Enable, disable and configure automatic server discovery.
Check for updates - Check for latest Thincast Client updates
About - Show the About dialog
The server list gives you a summary of all available servers and VM's in your network. Enable Server Auto-Discovery by clicking on Session Defaults in the menu bar and then on "Server Auto-Discovery". Double-click on a specific server will expand the list and display the available VM's from that server.
Note: Only users that are in the "Thincast Workstation Admins" user-group on your Thincast Workstation installation will be able to access, start and stop a VM from that server. Please refer to the Thincast Workstation User manual section "Windows Authentication".
After a connection to a VM has been established successfully, your virtualized desktop will appear inside Thincast Viewer.
All important actions can be accessed through the menu bar inside Thincast Viewer:
|Take Screenshot||Full Screen||USB Devices|
|Type Clipboard Text||Fit guest now||Disable keyboard grabbing||About|
|Start||Fit window now||Grab Mouse Ctrl + Alt + M|
|Insert Ctrl + Alt + Del||Auto Fit Guest||Install Guest Additions|
|Pause||Auto Fit Window|
|Stop VM||Smart Sizing|
|Auto-Pause VM on Disconnect||Disable Screensaver|
Take Screenshot - Take a screenshot. Screenshots will be saved to the clipboard and can be pasted into other applications.
Type Clipboard Text - Paste content from clipboard as single key strokes into your VM. This is very useful for login screens before drivers for clipboard redirection are loaded.
Start - Start a VM. Alternatively, you can use the "Play" button in the center of Thincast Viewer.
Insert Ctrl + Alt + Del - Type Ctrl + Alt + Del in your virtual machine
Pause - Pause your VM and preserve its current state
Stop VM - Shutdown the VM. You can choose between ACPI Shutdown and Power down
Auto-Pause VM on Disconnect - Automatically pause your VM and preserve the current state on Disconnect
Close - Disconnect from your VM and close the window.
Full Screen - Allows you to operate your virtualized desktop in Full Screen mode
Fit guest now - Adapt your guest's resolution to Thincast Viewer's current window size
Fit window now - Adapt the window size of Thincast Viewer to your guest's resolution
Auto Fit Guest - Automatically adapt your guest's resolution to Thincast Viewer's current window size
Auto Fit Window - Automatically adapt the window size of Thincast Viewer to your guest's resolution
Smart Sizing - Automatically stretches/shrinks the guest to Thincast Viewer's window size
Disable Screensaver - Disable the screensaver while Thincast Viewer is running and visible (i.e. not minimized)
USB Devices - Select a USB device to redirect it to your VM. Note: Only USB devices physically attached to the machine running Thincast Workstation will appear here.
Grab Mouse Ctrl + Alt + M - Exclusively grab the mouse in the TCViewer window. This is useful for applications that require direct mouse input like video games. To ungrab and free the mouse, use the shortcut Ctrl + Alt + M.
Disable keyboard grabbing - Disable the automatic keyboard grabbing
Install Guest Additions - Insert the Thincast Guest Additions image into your VM. Please refer to chapter "Installing Thincast Guest Additions" for more information.
About - Show the About dialog
Installing Thincast Guest Additions
- To install Thincast Guest Additions, connect to a virtual machine.
- In the menu bar of Thincast Viewer, click on "Devices" and select "Install Guest Additions", which mounts the Guest Additions image file inside your VM.
- Double-click on the inserted disc in your VM -> This PC.
- Accept with "Yes" to continue installation.
- The Thincast Guest Additions Setup Wizard will be opened. Click "Next" to proceed.
- Click "Next" to install Thincast Guest Additions in the default folder.
- Click "Install" to install Thincast Guest Additions.
- Select "Reboot now" and click "Finish" to complete the installation of Thincast Guest Additions.
- Your VM will reboot and Thincast Guest Additions installation will complete.
Please keep in mind that Thincast Client Beta and Nightly builds do not carry any warranties or support services.
However, we are eager to hear about your experience and any troubles with Thincast Client Beta! Please let us know by filling out our contact form.
Upload a TSRP
Our support staff might ask you to create a TSRP (Thincast Support Request Package).
on the computer where Thincast Client is installed and follow the instructions to upload the package.
Then we can analyze your submission to find the problem.
Note: TSRP creation is currently only available for Windows.
The changelog can be found on our website.
Open-source software licenses used in Thincast Client are located under