A lightweight cross-platform desktop client for Subsonic and Jellyfin music servers.
Jump to installation instructions
Screenshots of Supersonic running against the Navidrome demo server, showcasing the builtin dark and light themes.
Supersonic supports any music server with a Subsonic (or OpenSubsonic) API, or Jellyfin. A partial list of supported servers is as follows:
- Fast, lightweight, native UI with infinite scrolling
- Light and Dark themes, with optional auto theme switching
- High-quality gapless audio playback powered by MPV, with optional audio exclusive mode
- ReplayGain support (depends on files being tagged on server)
- Custom themes
- MPRIS and Mac OS media center integration for media key and desktop control
- Built-in 15-band graphic equalizer
- Scrobble plays to server, with configurable criteria
- Add and switch between multiple servers
- Primary and alternate server hostnames, e.g. for internal and external URLs
- Set filters in albums browsing view
- Play "artist radio" (mix of songs from given artist and similar artists, depends on your server's support)
- Sort tracklist views by column and configure visible tracklist columns
- Download songs, albums or playlists
- Shuffle and repeat playback modes (partial; shuffle album, playlist, artist radio, random songs; repeat one/all)
- Lyrics support
- Internet radio station support (Subsonic)
- Cast to uPnP/DLNA devices
- Server jukebox control (planned)
- Browse by folders (planned)
- Offline mode (eventually planned)
- iOS/Android support (maybe eventually planned)
Platform-specific installation instructions are listed below. In addition to the most recent stable release, you can also download the latest build from the main branch via the Actions tab to get unreleased features and bug fixes (you must be signed in to Github to do this). If you prefer to build from source, then see the build instructions for your platform.
Packages: On Linux, Supersonic is available as a Flatpak. (Thank you @anarcat!) Third-party packages are also available for Arch and Nix OS.
AppImage: On the latest release page, you can download an AppImage package which supports any OS that can run AppImages. The MPV library is bundled in the AppImage.
(Debian) .tar.xz: The.tar.xz builds from the Releases page support Debian-based distros. You must have libmpv installed on your system, and choose the correct release build (libmpv2 or libmpv1) based on which is available in your distro's package manager. On apt-based systems, run sudo apt install libmpv1 (or libmpv2) if it is not already installed. To install the Linux release build, after ensuring the required libmpv is installed, extract the .tar.xz bundle and run make user-install or sudo make install.
Download the latest release. You can choose between the installer, or a standalone zip file which can be extracted and run without requiring system installation.
Supersonic is available on Homebrew via a custom brew tap, or via downloading the .app bundle from the Releases page.
To install Supersonic with Homebrew run:
brew tap supersonic-app/supersonic
brew install --no-quarantine supersonicThe --no-quarantine flag is important because Supersonic is distributed without having been notarized, and therefore will not run without this.
You should also include it when upgrading in future:
brew upgrade --no-quarantine supersonic
To install the downloaded .app bundle from the Releases page, unzip and then drag Supersonic.app to the Applications folder.
Apple Silicon (M1/M2) Macs: You will have to remove the "quarantine bit" that Mac will automatically set, being an application downloaded from the internet. After copying the .app bundle to your Applications folder, in the terminal run sudo xattr -r -d com.apple.quarantine /Applications/Supersonic.app
Build instructions for Linux, Windows, and Mac are listed here
