Command-line cloud music player for Linux with support for Spotify, Google Play Music, YouTube, SoundCloud, Dirble, Plex servers and Chromecast devices.
Clone or download
Permalink
Failed to load latest commit information.
3rdparty release v0.15.0: update_debian_changelog_files (#497) Jun 15, 2018
cast release v0.15.0: update_debian_changelog_files (#497) Jun 15, 2018
clients release v0.15.0: update_debian_changelog_files (#497) Jun 15, 2018
config release v0.15.0: update_debian_changelog_files (#497) Jun 15, 2018
docs release v0.15.0: update_sphinx_doc_version_strings (#497) Jun 15, 2018
include release v0.15.0: update_debian_changelog_files (#497) Jun 15, 2018
libtizcore release v0.15.0: update_debian_changelog_files (#497) Jun 15, 2018
libtizonia release v0.15.0: update_debian_changelog_files (#497) Jun 15, 2018
libtizplatform release v0.15.0: update_debian_changelog_files (#497) Jun 15, 2018
m4 build system: added support for -with/without-libspotify (closes #396) Nov 30, 2017
pkgbuild pkgbuild: refreshed both aur packages to for v15 (#499) Sep 14, 2018
player release v0.15.0: update_debian_changelog_files (#497) Jun 15, 2018
plugins release v0.15.0: update_debian_changelog_files (#497) Jun 15, 2018
rm release v0.15.0: update_debian_changelog_files (#497) Jun 15, 2018
tools tools/install.sh: Added support for Kali Linux (which is based on Deb… Aug 29, 2018
.clang-format .clang-format: SpaceAfterCStyleCast -> true Oct 14, 2016
.dir-locals.el cast subtree: initial commit Nov 14, 2017
.github_changelog_generator Added .github_changelog_generator Dec 14, 2015
.gitignore .gitignore: ignored various files under 'clients/spotify' Jun 15, 2018
.hgignore docs: sphinx docs rework (initial drop) Nov 2, 2015
.travis.yml .travis.yml: reverted travis xenial builds May 2, 2018
BUILDING.md BUILDING.md: added a 'Prerequisites' section Dec 18, 2017
CHANGELOG.md release v0.15.0: CHANGELOG.md Jun 15, 2018
CODE_OF_CONDUCT.md CODE_OF_CONDUCT.md: added code of conduct Mar 20, 2018
CONTRIBUTING.md CODE_OF_CONDUCT.md: added code of conduct Mar 20, 2018
COPYING.LESSER Initial commit Jan 1, 2013
ISSUE_TEMPLATE.md CONTRIBUTING.md: added contribution guidelines Mar 20, 2018
Makefile.am Bumped copyright year Feb 11, 2018
PROJECT.md CONTRIBUTING.md: added contribution guidelines Mar 20, 2018
README.md README.md: Added links in Roadmap section Aug 29, 2018
configure.ac release 0.15.0: update_package_versions Jun 15, 2018
description-pak More copyright year updates Feb 11, 2018

README.md

Tizonia logo

The Tizonia Project

  • A command-line streaming music client/server for Linux.
  • Support for Spotify (Premium), Google Play Music (free and paid tiers), YouTube, SoundCloud, Dirble, Plex servers and Chromecast devices.
  • The first open-source implementation of OpenMAX IL 1.2.

Build Status | Coverity Scan Build Status | Codecov | GitHub commits | Codacy Badge | license | CII Best Practices | [Gitter chat]

News

NOTE: Please remember to also visit Tizonia's website at http://www.tizonia.org for more info on the latest releases.

  • [2018-06-15] Tizonia v0.15.0. Reworked Spotify support to overcome playlist search problems that arised in libspotify. Now spotipy is being used to retrieve track, artist, album, and playlist metadata from Spotify.

  • [2018-04-20] Tizonia v0.14.0. Added support for Google Play Music stations for non-subscribers and YouTube channels (uploads and playlists). Also added option to play the user's entire Google Play Music library.

  • [2018-03-09] Tizonia v0.13.0. Added support for Plex servers. Various improvements and bug fixes in Google Music, SoundCloud, Dirble and Spotify.

  • [2018-02-11] Tizonia v0.12.0. Chromecast support is now available for Google Play Music, YouTube, SoundCloud, and Dirble playlists and standalone HTTP radio stations (casting of Spotify and local media to be included in a future release).

  • [2017-12-28] Snap Package and Docker Image available.

  • [2017-08-26] tizonia-all and tizonia-all-git packages submitted to the Arch User Repository

  • [2017-05-04] Summer of Code 2017: Add OpenMAX state tracker in Mesa/Gallium that uses Tizonia (X.Org Foundation project, with Gurkirpal Singh and Julien Isorce).

Installation

Debian / Ubuntu / Raspbian

Available from Bintray, with the following distro/arch combinations:

Ubuntu Xenial (16.04) Ubuntu Bionic (18.04) Debian Stretch (9) Raspbian Stretch (9) Debian Buster (10)
amd64, armhf amd64, armhf amd64, armhf armhf amd64
Download Download Download Download Download

NOTE: Elementary OS, Linux Mint, Kali Linux are supported on releases based on Ubuntu 'Xenial' or 'Bionic' and Debian 'Buster'.

Please note that the recommended way to install Tizonia on a Debian-compatible system is by running the following command:

    $ curl -kL https://github.com/tizonia/tizonia-openmax-il/raw/master/tools/install.sh | bash

    # Or its shortened version:

    $ curl -kL https://goo.gl/Vu8qGR | bash

NOTE: This script installs the latest release and all the dependencies.

NOTE: The usual disclaimers apply: trust no-one. You should have a look at the installation script before running it on your system!.

Arch User Repository (AUR)

    $ yaourt -S tizonia-all # for the latest stable release

    # or

    $ yaourt -S tizonia-all-git # for the bleeding edge

Snap Package

A 'snap' package is now available to download from the 'Global' snap store ('stable' channel). For more details visit:

To install, first visit Install Snapd and make sure that your Linux distro is supported. Follow the instructions to get the 'snapd' service running on your system, and finally use this command to install Tizonia:

$ sudo snap install tizonia

Tizonia's snapcraft.yaml file is hosted in its own repository:

Docker Image

Tizonia can also be run from a Docker container. A Docker image is available from the Docker hub:

Configuration

To use Spotify, Google Play Music, SoundCloud, Dirble and Plex introduce your credentials in Tizonia's config file (see instructions inside this file for more information):

    ( On first use, Tizonia outputs its configuration file, if it is not there yet )

    $ tizonia --help

    ( now edit $HOME/.config/tizonia/tizonia.conf )

    ( NOTE: If Tizonia was installed from the 'snap' package, use this path instead )
    ( $HOME/snap/tizonia/current/.config/tizonia/tizonia.conf )

Upgrade (Debian / Ubuntu / Raspbian)

To upgrade, simply re-run the install script. This is the most convienent way of upgrading the software and all its dependencies.

If you prefer to do it manually, it is a two-step process. Run 'apt-get' as usual to upgrade the Debian packages, but also make sure the various Python dependencies are up-to-date, as follows:

    # Step1: This will update Tizonia's Debian packages
    $ sudo apt-get update && sudo apt-get upgrade

    # Step2: Tizonia's Python dependencies
    # (Note that new versions of some of these Python packages are released frequently,
    # so you should do this frequently, even if there isn't a new Tizonia release)
    $ sudo -H pip install --upgrade gmusicapi soundcloud youtube-dl pafy pycountry titlecase pychromecast plexapi fuzzywuzzy eventlet && sudo -H pip install git+https://github.com/plamere/spotipy.git --upgrade

Roadmap

Roughly in priority order:

  • Pandora support (#340).
  • RPC interface / headless support (#488).
  • Airsonic/Subsonic support (#496).
  • Deezer support (#498)
  • Tidal support (#440)
  • OS X port (#316).
  • Support for YouTube live streams (#391).
  • REPL command-line interface.

Resources