How to Run the Splashtop Windows Viewer Client on Linux
This is shamelessly stolen from the following website, and I’d prefer you go there for the data, since they put in the work. I’ve only copied it here in case it’s ever not available there, I want a backup.
https://help.swif.ai/en/articles/12625363-how-to-run-the-splashtop-windows-viewer-client-on-linux
This guide explains how to run the Splashtop RMM Windows Viewer client app on a Linux machine so that administrators can remotely access Mac or Windows devices running the Splashtop Streamer.
Prerequisites
Linux Distribution: Ubuntu 24.04 (tested)
Also tested on Linux Mint as of 3-30-26
Wine Version: 9.16 or higher (Wine 10.0 recommended)
Fonts: Microsoft TrueType Core Fonts (required for proper rendering)
Step 1: Install Wine and Microsoft Fonts
First, add the Wine repository and install the stable version of Wine along with the Microsoft TrueType fonts package.
wget -O – https://dl.winehq.org/wine-builds/winehq.key | sudo gpg –dearmor -o /etc/apt/keyrings/winehq-archive.key –
sudo wget -NP /etc/apt/sources.list.d/ https://dl.winehq.org/wine-builds/ubuntu/dists/noble/winehq-noble.sources
sudo apt update && sudo apt install –install-recommends winehq-stable ttf-mscorefonts-installer
💡 Tip:
Verify your Wine installation with:
​wine –version
Ensure it shows wine-9.16 or later.
Step 2: Download and Install Splashtop RMM
Log in to your Swif.ai portal.
Download the Splashtop RMM Windows Viewer installer (e.g. Splashtop_RMM_Win_INSTALLER_v3.7.6.0.exe).
Run the installer using Wine:
wine ~/Downloads/Splashtop_RMM_Win_INSTALLER_v3.7.6.0.exe
This will install the Splashtop RMM Viewer client under:
​~/.wine/drive_c/Program Files (x86)/Splashtop/Splashtop Remote/Client for RMM/
Step 3: Register the Desktop Shortcut and MIME Handler
To allow the Linux desktop to recognize Splashtop RMM links from your browser (e.g., when launching from the Swif RMM portal), create and run the following registration script.
Create a new file called rmm-register.sh in your home directory.
Paste the following content:
#!/bin/bash
# Registers the Splashtop RMM Viewer client to open remote sessions via Wine.
file_path=$HOME/.local/share/applications/splashtop-viewer.desktop
cat << EOF > “$file_path”
[Desktop Entry]
Encoding=UTF-8
Name=Splashtop RMM
Exec=wine “$HOME/.wine/drive_c/Program Files (x86)/Splashtop/Splashtop Remote/Client for RMM/clientoobe.exe” -a %u
Type=Application
StartupNotify=true
Terminal=false
MimeType=x-scheme-handler/st-rmm;
EOF
Save and run the script as your normal user (no sudo needed):
bash ~/rmm-register.sh
This registers the Splashtop RMM protocol handler (st-rmm://) so that Linux can automatically open remote desktop sessions launched from the Swif.ai portal.
Step 4: Connect to Remote Devices
Once registered:
Open the Swif.ai RMM or device management portal.
Launch a remote session from any managed Mac or Windows device running the Splashtop Streamer.
The Splashtop RMM Viewer client will open on your Linux machine via Wine and connect as expected.
Troubleshooting
Issue
Possible Cause
Solution
Splashtop Viewer client doesn’t launch
Missing MIME registration
Re-run the rmm-register.sh script
Fonts or UI appear broken
Missing TTF fonts
Reinstall ttf-mscorefonts-installer
Error running Wine
Incompatible version
Upgrade Wine to 9.16 or later
Streamer connection fails
Firewall or network restriction
Verify port access for Splashtop services
Summary
You can now use the Splashtop RMM Viewer client on Linux to access remote Mac and Windows devices directly through the Swif.ai portal.
Although this configuration is not officially supported by Swif.ai, it works reliably when Wine is properly installed and registered as shown above.