Note:
This guide is community-contributed and provided as-is. Swif.ai does not officially support the Splashtop RMM Viewer client on Linux. However, these steps have been successfully tested by users running Ubuntu 24.04.
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)
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.shin 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
sudoneeded):
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 |
Fonts or UI appear broken | Missing TTF fonts | Reinstall |
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.