Skip to content

Shipping a Tauri 2 app on Linux: blank windows, keyrings and deep links

What broke when the Melodius desktop app moved from Windows to Linux with Tauri 2, and the fixes: origins, custom schemes, the Secret Service keyring, WebKitGTK quirks, MPRIS and deep links in AppImage, .deb and .rpm.

3 min read

The Melodius desktop app started on Windows with Tauri 2. Tauri promises cross-platform, and mostly delivers, but Linux uses WebKitGTK instead of WebView2, and the app had quietly assumed Windows in a few places. Version 1.13.1 shipped for Linux as AppImage, .deb and .rpm after these fixes.

Windows assumptions

  • Blank window: the navigation guard only knew the Windows origin. On Linux the app's origin is tauri://localhost, which the guard blocked. It now allows both.
  • API calls: requests went to a custom host only WebView2 serves. On Linux the custom scheme is reached as api://localhost.
  • Media keys: Linux desktops expect MPRIS for play/pause keys and the media panel, so the app now publishes it.

WebKitGTK is not WebView2

  • No requestIdleCallback. The app warmed up screens in idle time. On WebKitGTK the call threw, which unmounted the whole UI right after sign-in: a blank window again. Where it is missing, screens now warm after a short delay.
  • Animation cost. An animated veil on the sign-in screen held WebKitGTK to about 6 frames a second, and each key press took a quarter of a second. On Linux it now draws one still frame, as it does for reduced motion, which brought typing back to normal speed.

Where to keep the session

At first the Linux session lived only in memory, so every restart signed you out. It now goes to the Secret Service keyring, the standard Linux secret store. Some desktops have no default keyring collection and refused every sign-in with "no result found"; there the session falls back to a file in the app's data folder that only the user can read.

Sign-in returns to the app through a melodius:// link. Each format needed its own handling: AppImages register the scheme when they start, while the .deb and .rpm desktop entries must pass the link with %u. Without it, GNOME and KDE opened the app but dropped the sign-in callback.

Testing on real distros

Packages are built in a resource-capped container and tested on clean Ubuntu 22.04 and 24.04, Debian 12, and Fedora 41 and 42, with every check passing on each package and distro. The reasons the desktop app is the web UI in Tauri at all are in one music app on four platforms.

Illustrated avatar of Kumar Manas

Written by Kumar Manas

Full-stack developer in India. I build Melodius and Krypton.

Related projectMelodius: music streaming platform