Welcome to Sublime Music’s documentation!
Sublime Music is a native, GTK3 Subsonic/Airsonic/Revel/Gonic/Navidrome/*sonic client for the Linux Desktop.
Features
Switch between multiple Subsonic-API-compliant 1 servers.
Play music through Chromecast devices on the same LAN.
Offline Mode where Sublime Music will not make any network requests.
DBus MPRIS interface integration for controlling Sublime Music via clients such as
playerctl
,i3status-rust
, KDE Connect, and many commonly used desktop environments.Browse songs by the sever-reported filesystem structure, or view them organized by ID3 tags in the Albums, Artists, and Playlists views.
Intuitive play queue.
Create/delete/edit playlists.
Download songs for offline listening.
- 1
Requires a server which implements the Subsonic API version 1.8.0+.
Installation
Via the AUR:
Install the sublime-music
package. Example using yay
:
yay -S sublime-music
If you want support for storing passwords in the system keychain, also install
python-keyring
.
If you want support for playing on Chromecast devices, install
python-pychromecast
. If you want to serve cached files from your computer
over the LAN to Chromecast devices also install python-bottle
.
Via NixOS:
Sublime Music is part of the nixos-20.09
channel and newer (including
nixos-unstable
).
To install Sublime Music on NixOS, either use the declarative or the imperative way:
In
configuration.nix
(declarative):environment.systemPackages = [ pkgs.sublime-music ];
In command line (imperative):
nix-env -iA sublime-music
To customize the extra components installed, you need to use the override
function provided by Nix:
(sublime-music.override {
serverSupport = true;
chromecastSupport = true;
})
The following components are supported:
chromecastSupport
: if you want support for playing on Chromecast devices on the LAN. Defaults tofalse
.serverSupport
: if you want to be able to serve cached files from your computer over the LAN to Chromecast devices. Defaults tofalse
.keyringSupport
: if you want to store your passwords in the system keyring instead of in plain-text. Defaults totrue
.notifySupport
: if you want to enable notifications when a new song begins to play. Defaults totrue
.networkSupport
: if you want to change the address used to access the server depending on what network you are connected to. Defaults totrue
.
See Nix package management for more information.
Via the Debian package
Sublime Music is not currently in the Debian ‘Stable’ distribution, but has been packaged for Debian ‘Unstable’ and ‘Testing’.
If you have these sources in your /etc/apt/sources.list
, you can install
the package with:
sudo apt install sublime-music
Via PyPi:
pip install sublime-music
There are a few optional dependencies that you can install. Here’s an example of how to do that:
pip install sublime-music[keyring,chromecast,server]
keyring
: if you want to store your passwords in the system keyring instead of in plain-textchromecast
: if you want support for playing on Chromecast devices on the LAN.server
: if you want to be able to serve cached files from your computer over the LAN to Chromecast devices
Note
Sublime Music requires Python 3.8. Please make sure that you have that
installed. You may also need to use pip3
instead of pip
if you are on
an OS that hasn’t deprecated Python 2 yet.