Metadata-Version: 2.1
Name: sublime-music
Version: 0.11.8
Summary: A native GTK *sonic client.
Home-page: https://gitlab.com/sublime-music/sublime-music
Author: Sumner Evans
Author-email: inquiries@sumnerevans.com
License: GPL3
Description: .. image:: https://gitlab.com/sublime-music/sublime-music/-/raw/master/logo/logo.png
           :alt: Sublime Music Logo
        
        Sublime Music is a native, GTK3
        `Subsonic`_/`Airsonic`_/`Revel`_/`Gonic`_/`Navidrome`_/\*sonic client for the
        Linux Desktop.
        
        .. _Subsonic: http://www.subsonic.org/pages/index.jsp
        .. _Airsonic: https://airsonic.github.io/
        .. _Revel: https://gitlab.com/robozman/revel
        .. _Gonic: https://github.com/sentriz/gonic
        .. _Navidrome: https://www.navidrome.org/
        
        .. figure:: https://gitlab.com/sublime-music/sublime-music/-/raw/master/docs/_static/screenshots/play-queue.png
           :align: center
           :target: 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 <https://sublime-music.gitlab.io/sublime-music/screenshots.html_>`_
        
        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 |AUR 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``.
        
        .. |AUR Package| replace:: ``sublime-music`` package
        .. _AUR Package: https://aur.archlinux.org/packages/sublime-music/
        
        **Via NixOS**:
        
        Sublime Music is part of the nixpkgs-unstable channel that is used by NixOS_.
        
        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
        * ``serverSupport``: if you want to be able to serve cached files from your
          computer over the LAN to Chromecast devices
        * ``keyringSupport``: if you want to store your passwords in the system keyring
          instead of in plain-text
        * ``notifySupport``: if you want to enable notifications when a new song begins
          to play
        * ``networkSupport``: if you want to change the address used to access the
          server depending on what network you are connected to.
        
        See `Nix package management`_ for more information.
        
        .. _NixOS: https://nixos.org/nixos
        .. _Nix package management: https://nixos.org/nixos/manual/index.html#sec-package-management
        
        **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.
        
        Then, you can install Sublime Music with::
        
            sudo flatpak install sublime-music.flatpak
        
        and run it by executing::
        
            flatpak run app.sublimemusic.SublimeMusic
        
        .. _Releases: https://gitlab.com/sublime-music/sublime-music/-/releases
        
        **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
        
        .. 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.
        
        -------------------------------------------------------------------------------
        
        |website|_
        
        .. |website| replace:: **Click HERE for the Sublime Music website.**
        .. _website: https://sublimemusic.app
        
        |userdoc|_
        
        .. |userdoc| replace:: **Click HERE for extended user documentation.**
        .. _userdoc: https://sublime-music.gitlab.io/sublime-music/
        
        See the |contributing|_ document for how to contribute to this project.
        
        .. |contributing| replace:: ``CONTRIBUTING.rst``
        .. _contributing: https://gitlab.com/sublime-music/sublime-music/-/blob/master/CONTRIBUTING.rst
        
        You can also join the conversation in our Matrix room:
        `#sublime-music:matrix.org <https://matrix.to/#/!veTDkgvBExJGKIBYlU:matrix.org?via=matrix.org>`_.
        
Keywords: airsonic subsonic libresonic gonic music
Platform: UNKNOWN
Classifier: Development Status :: 3 - Alpha
Classifier: Intended Audience :: End Users/Desktop
Classifier: Operating System :: POSIX
Classifier: License :: OSI Approved :: GNU General Public License v3 (GPLv3)
Classifier: Programming Language :: Python :: 3.8
Provides-Extra: keyring
Provides-Extra: chromecast
Provides-Extra: server
