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, Plex servers and Chromecast devices. - The first open-source implementation of OpenMAX IL 1.2.
, 
, 
, 
, ,
, ,
News
NOTE: Please remember to also visit Tizonia's website at
http://tizonia.org There is always some additional info on what is going on
in the project and in the latest releases.
-
[2019-12-13] Tizonia
v0.19.0. Another
maintenance release with a good bunch of improvements and bug fixes: Dirble
removal (the service is sadly gone), Python 3 migration (please see the section
Upgrade (Debian / Ubuntu / Raspbian) to learn
how to install the new Python 3 dependencies!). -
[2019-03-13] Tizonia
v0.18.0. Various
improvements and bug fixes in Google Music and Spotify. -
[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. -
[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 Buster (10), Raspbian Buster (10), Debian Bullseye (11), :---:, :---:, :---:, :---:, :---:, amd64, amd64, armhf, amd64, armhf, armhf, amd64, 
, 
, 
, 
, 
, > NOTE: Elementary OS, Linux Mint, Kali Linux are supported on releases based on Ubuntu 'Xenial' or 'Bionic', Debian 'Buster' or 'Bullseye'. To install Tizonia on other Debian or Ubuntu-based OSes, use the Snap package or have a look at #631.
Please note that the recommended way of installing 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:
- Tizonia's landing page on Snapcraft.io
or - Tizonia on uApp Explorer
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 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 that the various
Python dependencies are up-to-date, as follows:
# Step1: update Tizonia's Debian packages
$ sudo apt-get update && sudo apt-get upgrade
# Step2: update Tizonia's Python dependencies
# (Note that new versions of some of these Python dependencies are released often,
# so you should do this frequently, even if there isn't a new Tizonia release)
# For Tizonia v0.19.0 or newer: Python 3 dependencies
$ sudo -H pip3 install --upgrade gmusicapi soundcloud youtube-dl pafy pycountry titlecase pychromecast plexapi fuzzywuzzy eventlet python-Levenshtein && sudo -H pip3 install git+https://github.com/plamere/spotipy.git --upgrade
# For Tizonia v0.18.0 or older: Python 2 dependencies
$ sudo -H pip2 install --upgrade gmusicapi soundcloud youtube-dl pafy pycountry titlecase pychromecast plexapi fuzzywuzzy eventlet python-Levenshtein && sudo -H pip2 install git+https://github.com/plamere/spotipy.git --upgrade
Roadmap
Roughly in priority order:
- REPL command-line interface.
- TuneIn support.
- Colored output options/theming (#586).
- RPC interface / headless support (#488, #509, #551).
- Pandora support (#340).
- Airsonic/Subsonic support (#496).
- Deezer support (#498)
- Tidal support (#440)
- OS X port (#316).
- YouTube live streams (#391).
Resources
-
See PROJECT.md to discover other facts about the project.
-
See CONTRIBUTING.md to learn how to contribute to Tizonia.
-
See CODE_OF_CONDUCT.md to keep Tizonia an open and welcoming environment.
-
See BUILDING.md for instructions on how to build Tizonia from source.
-
See docs.tizonia.org for the project's official documentation.
-
The Wiki may also
contain some useful information (although in need of an update). -
See CHANGELOG.md for details on what has gone into each
release of the project. -
Tizonia OpenMAX IL is released under the GNU Lesser General Public
License version 3. -
Finally, please visit the project web site at http://tizonia.org