Skip to main content

A native GTK *sonic client.

Project description

Sublime Music Logo

Sublime Music is a native, GTK3 Subsonic/Airsonic/Revel/Gonic/Navidrome/Ampache/*sonic client for the Linux Desktop.

CI
GitLab build status sourcehut build status code coverage report
Community
Matrix chat GPLv3 or later liberapay donate
Packages
Packaging status

https://gitlab.com/sublime-music/sublime-music/-/raw/master/docs/_static/screenshots/play-queue.png

The Albums tab of Sublime Music with the Play Queue opened. More Screenshots

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.

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 to false.

  • serverSupport: if you want to be able to serve cached files from your computer over the LAN to Chromecast devices. Defaults to false.

  • keyringSupport: if you want to store your passwords in the system keyring instead of in plain-text. Defaults to true.

  • notifySupport: if you want to enable notifications when a new song begins to play. Defaults to true.

  • networkSupport: if you want to change the address used to access the server depending on what network you are connected to. Defaults to true.

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 Flatpak:

In the future, you will be able to install via Flathub. For now, if you want to try the Flatpak, you will have to install it manually by visiting the Releases page and downloading the .flatpak file from there.

Next, install the dependencies for Sublime Music. If you haven’t already, follow the instructions to setup flathub here: https://docs.flatpak.org/en/latest/using-flatpak.html#add-a-remote

Then, install the dependencies of Sublime Music:

sudo flatpak install -y org.gnome.Platform//3.38 org.gnome.Sdk//3.38

And finally, install Sublime Music with:

sudo flatpak install sublime-music.flatpak

To run Sublime, use the following command:

flatpak run app.sublimemusic.SublimeMusic

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-text

  • chromecast: 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


Click HERE for the Sublime Music website.

Click HERE for extended user documentation.

See the CONTRIBUTING.md document for how to contribute to this project.

You can also join the conversation in our Matrix room: #sublime-music:matrix.org.

Project details


Download files

Download the file for your platform. If you're not sure which to choose, learn more about installing packages.

Source Distribution

sublime_music-0.11.12.tar.gz (158.2 kB view hashes)

Uploaded Source

Built Distribution

sublime_music-0.11.12-py3-none-any.whl (183.6 kB view hashes)

Uploaded Python 3

Supported by

AWS AWS Cloud computing and Security Sponsor Datadog Datadog Monitoring Fastly Fastly CDN Google Google Download Analytics Microsoft Microsoft PSF Sponsor Pingdom Pingdom Monitoring Sentry Sentry Error logging StatusPage StatusPage Status page