https:\/\/help.swif.ai\/en\/articles\/12625363-how-to-run-the-splashtop-windows-viewer-client-on-linux<\/a><\/p>\n\n\n\nThis 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.<\/p>\n\n\n\n
Prerequisites
Linux Distribution: Ubuntu 24.04 (tested)
Also tested on Linux Mint as of 3-30-26<\/p>\n\n\n\n
Wine Version: 9.16 or higher (Wine 10.0 recommended)<\/p>\n\n\n\n
Fonts: Microsoft TrueType Core Fonts (required for proper rendering)<\/p>\n\n\n\n
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.<\/p>\n\n\n\n
wget -O – https:\/\/dl.winehq.org\/wine-builds\/winehq.key | sudo gpg –dearmor -o \/etc\/apt\/keyrings\/winehq-archive.key –<\/p>\n\n\n\n
sudo wget -NP \/etc\/apt\/sources.list.d\/ https:\/\/dl.winehq.org\/wine-builds\/ubuntu\/dists\/noble\/winehq-noble.sources<\/p>\n\n\n\n
sudo apt update && sudo apt install –install-recommends winehq-stable ttf-mscorefonts-installer
\ud83d\udca1 Tip:
Verify your Wine installation with:
\u200bwine –version
Ensure it shows wine-9.16 or later.<\/p>\n\n\n\n
Step 2: Download and Install Splashtop RMM
Log in to your Swif.ai portal.<\/p>\n\n\n\n
Download the Splashtop RMM Windows Viewer installer (e.g. Splashtop_RMM_Win_INSTALLER_v3.7.6.0.exe).<\/p>\n\n\n\n
Run the installer using Wine:<\/p>\n\n\n\n
wine ~\/Downloads\/Splashtop_RMM_Win_INSTALLER_v3.7.6.0.exe
This will install the Splashtop RMM Viewer client under:
\u200b~\/.wine\/drive_c\/Program Files (x86)\/Splashtop\/Splashtop Remote\/Client for RMM\/<\/p>\n\n\n\n
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.<\/p>\n\n\n\n
Create a new file called rmm-register.sh in your home directory.<\/p>\n\n\n\n
Paste the following content:<\/p>\n\n\n\n
#!\/bin\/bash
# Registers the Splashtop RMM Viewer client to open remote sessions via Wine.<\/p>\n\n\n\n
file_path=$HOME\/.local\/share\/applications\/splashtop-viewer.desktop<\/p>\n\n\n\n
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):<\/p>\n\n\n\n
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.<\/p>\n\n\n\n
Step 4: Connect to Remote Devices
Once registered:<\/p>\n\n\n\n
Open the Swif.ai RMM or device management portal.<\/p>\n\n\n\n
Launch a remote session from any managed Mac or Windows device running the Splashtop Streamer.<\/p>\n\n\n\n
The Splashtop RMM Viewer client will open on your Linux machine via Wine and connect as expected.<\/p>\n\n\n\n
Troubleshooting
Issue<\/p>\n\n\n\n
Possible Cause<\/p>\n\n\n\n
Solution<\/p>\n\n\n\n
Splashtop Viewer client doesn\u2019t launch<\/p>\n\n\n\n
Missing MIME registration<\/p>\n\n\n\n
Re-run the rmm-register.sh script<\/p>\n\n\n\n
Fonts or UI appear broken<\/p>\n\n\n\n
Missing TTF fonts<\/p>\n\n\n\n
Reinstall ttf-mscorefonts-installer<\/p>\n\n\n\n
Error running Wine<\/p>\n\n\n\n
Incompatible version<\/p>\n\n\n\n
Upgrade Wine to 9.16 or later<\/p>\n\n\n\n
Streamer connection fails<\/p>\n\n\n\n
Firewall or network restriction<\/p>\n\n\n\n
Verify port access for Splashtop services<\/p>\n\n\n\n
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.<\/p>\n\n\n\n
Although this configuration is not officially supported by Swif.ai, it works reliably when Wine is properly installed and registered as shown above.<\/p>\n","protected":false},"excerpt":{"rendered":"
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 […]<\/p>\n","protected":false},"author":9,"featured_media":0,"comment_status":"closed","ping_status":"closed","sticky":false,"template":"","format":"standard","meta":{"footnotes":""},"categories":[1],"tags":[],"class_list":["post-1894","post","type-post","status-publish","format-standard","hentry","category-uncategorized","post-preview"],"_links":{"self":[{"href":"https:\/\/www.ultrexstaff.com\/index.php?rest_route=\/wp\/v2\/posts\/1894","targetHints":{"allow":["GET"]}}],"collection":[{"href":"https:\/\/www.ultrexstaff.com\/index.php?rest_route=\/wp\/v2\/posts"}],"about":[{"href":"https:\/\/www.ultrexstaff.com\/index.php?rest_route=\/wp\/v2\/types\/post"}],"author":[{"embeddable":true,"href":"https:\/\/www.ultrexstaff.com\/index.php?rest_route=\/wp\/v2\/users\/9"}],"replies":[{"embeddable":true,"href":"https:\/\/www.ultrexstaff.com\/index.php?rest_route=%2Fwp%2Fv2%2Fcomments&post=1894"}],"version-history":[{"count":3,"href":"https:\/\/www.ultrexstaff.com\/index.php?rest_route=\/wp\/v2\/posts\/1894\/revisions"}],"predecessor-version":[{"id":1897,"href":"https:\/\/www.ultrexstaff.com\/index.php?rest_route=\/wp\/v2\/posts\/1894\/revisions\/1897"}],"wp:attachment":[{"href":"https:\/\/www.ultrexstaff.com\/index.php?rest_route=%2Fwp%2Fv2%2Fmedia&parent=1894"}],"wp:term":[{"taxonomy":"category","embeddable":true,"href":"https:\/\/www.ultrexstaff.com\/index.php?rest_route=%2Fwp%2Fv2%2Fcategories&post=1894"},{"taxonomy":"post_tag","embeddable":true,"href":"https:\/\/www.ultrexstaff.com\/index.php?rest_route=%2Fwp%2Fv2%2Ftags&post=1894"}],"curies":[{"name":"wp","href":"https:\/\/api.w.org\/{rel}","templated":true}]}}