Support

FAQ

Practical answers for downloads, server compatibility, Orbit and support.

What is Psysonic?
A modern desktop client for self-hosted music libraries, built primarily for Navidrome (and compatible with other Subsonic servers). Built with Rust, Tauri v2 and React, focused on speed, polish and practical library workflows.
Who is Psysonic for?
People who self-host their music and want a fast, native, polished desktop client — whether they're self-hosting experts or just getting started.
Is Psysonic only for experienced self-hosting users?
No. It's powerful but approachable: downloads and setup are easy to find, and advanced paths like AUR or Nix are explained in plain language.
Is Psysonic only for Navidrome?
It's built primarily for Navidrome, but also works with Gonic, Airsonic, LMS and other Subsonic-compatible servers. Some advanced features depend on what your server supports.
Why do some features depend on Navidrome?
Psysonic binds Navidrome-native capabilities (server-side smart-playlist editing, playback reporting, OpenSubsonic probing) that generic Subsonic servers don't expose.
Where can I download Psysonic?
From GitHub Releases (Windows, macOS, Linux), and via package managers: AUR, Nix/Cachix and WinGet. See the Downloads page.
Which Windows download should I choose?
The Windows installer (*_x64-setup.exe) for regular 64-bit PCs. Or install via WinGet: winget install Psysonic.
Which Linux download should I choose?
AppImage for most distributions (portable: mark executable and run). DEB for Debian/Ubuntu/Mint, RPM for Fedora/openSUSE/RHEL. Arch users: use the AUR. Archives are for advanced/custom setups.
Which macOS download should I choose?
Apple Silicon (M1/M2/M3 or newer): the aarch64 DMG. Older Intel Macs: the x64 DMG. DMGs are signed.
How do I install Psysonic on Arch Linux?
Via the AUR: yay -S psysonic (builds from source) or yay -S psysonic-bin (prebuilt).
How do I use Psysonic with Nix / Cachix?
cachix use psysonic to use the binary cache, then nix run github:Psysonic/psysonic.
Where is the changelog?
On the Changelog page, pulled from the latest GitHub release notes. Full history lives on the GitHub Releases page.
What is Orbit?
Orbit is Psysonic's shared listening mode. One person hosts the music, others join through an invite link and listen in sync. Guests can suggest tracks; the host decides what gets added to the queue unless auto-approval is enabled.
Does Orbit need an external server or extra account?
No. Orbit uses your existing Navidrome server and regular playlists as transport — no relay, no hosted sync service, no extra account.
What does Orbit require?
Everyone needs access to the same Navidrome server with their own Navidrome user. For friends outside your network, the server must be reachable publicly.
Can guests change my queue in Orbit?
Guests can suggest tracks; the host stays in control and approves them unless auto-approval is enabled.
Is Psysonic stable?
We take an enterprise-grade approach to development — continuously improving our automated testing and maintaining strict contracts between the backend and the frontend. Releases are cut from green CI, not vibes.
How can I report bugs or give feedback?
Through GitHub Issues, or the Discord and Telegram communities (links in the footer / on GitHub).