Command-line cloud music player for Linux with support for Spotify, Google Play Music, YouTube, SoundCloud, Dirble, Plex servers and Chromecast devices.
Branch: master
Clone or download
juanrubio tools/install.sh: Install python-Levenshtein. Also added check to mak…
…e sure

that the essential build dependencies were installed.
Latest commit e04790e Feb 8, 2019
Permalink
Type Name Latest commit message Commit time
Failed to load latest commit information.
3rdparty release 0.17.0: update_debian_changelog_files Jan 17, 2019
cast release 0.17.0: update_debian_changelog_files Jan 17, 2019
clients release 0.17.0: update_debian_changelog_files Jan 17, 2019
config release 0.17.0: update_debian_changelog_files Jan 17, 2019
docs release 0.17.0: update_sphinx_doc_version_strings Jan 17, 2019
include release 0.17.0: update_debian_changelog_files Jan 17, 2019
libtizcore release 0.17.0: update_debian_changelog_files Jan 17, 2019
libtizonia release 0.17.0: update_debian_changelog_files Jan 17, 2019
libtizplatform release 0.17.0: update_debian_changelog_files Jan 17, 2019
m4 build system: added support for -with/without-libspotify (closes #396) Nov 30, 2017
pkgbuild pkgbuild: updated aur packages for 0.17.0 Jan 19, 2019
player release 0.17.0: update_debian_changelog_files Jan 17, 2019
plugins release 0.17.0: update_debian_changelog_files Jan 17, 2019
rm release 0.17.0: update_debian_changelog_files Jan 17, 2019
tools tools/install.sh: Install python-Levenshtein. Also added check to mak… Feb 8, 2019
.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 Bumped copyright years to 2019 Jan 17, 2019
BUILDING.md BUILDING.md: added a 'Prerequisites' section Dec 18, 2017
CHANGELOG.md release 0.17.0: update_changelog Jan 17, 2019
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 years to 2019 Jan 17, 2019
PROJECT.md CONTRIBUTING.md: added contribution guidelines Mar 20, 2018
README.md README.md: minor changes Jan 26, 2019
configure.ac release 0.17.0: update_package_versions Jan 17, 2019
description-pak Bumped copyright years to 2019 Jan 17, 2019

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 There is always some more info on what is going on with the latest releases.

  • [2019-01-17] Tizonia v0.17.0. Fixed Spotify login issues. A regression introduced in v0.16.0. This issue was identified and fixed thanks to the great feedback provided by the users in issue #531.

  • [2018-12-03] Tizonia v0.16.0. Improved Spotify support with more options to dicover new music rather than just playing the content that you know and love. Last but not least, docker-tizonia has been updated! (many thanks to Josh5).

  • [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.

  • [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)

    # Please note that if you are upgrading your existing
    # Tizonia installation, you *need* to uninstall it before installing a new version.
    # See GitHub issue https://github.com/tizonia/tizonia-openmax-il/issues/485

    # For the latest stable release
    $ git clone https://aur.archlinux.org/tizonia-all.git
    $ cd tizonia-all
    $ makepkg -si

    # or for the bleeding edge
    $ git clone https://aur.archlinux.org/tizonia-all-git.git
    $ cd tizonia-all
    $ makepkg -si

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, #509, #551).
  • 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