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, TuneIn and iHeart Internet Radio directories, Plex servers and Chromecast devices.
• The first open-source implementation of OpenMAX IL 1.2.

---

Latest news

• [2020-05-22] Tizonia v0.22.0. Added support for iHeart radio, new command-line options to play Spotify recommendations by artist and album name, new keyboard shortcuts and a good number of other fixes and improvements.

See Tizonia's website: Tizonia 0.22.0

Show more

Installation

Debian / Ubuntu / Raspbian

Run the following command to install Tizonia on a Debian-compatible system:

$ 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.

DISCLAIMER: Trust no-one. Please have a look at the installation script before running it on your system!.

Debian packages are stored on Bintray, with the following distro/arch combinations:

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 versions of Debian or Ubuntu-based distros, use the Snap package or have a look at #631.

Arch User Repository (AUR)

Show details

$ git clone https://aur.archlinux.org/tizonia-all.git
$  tizonia-all
$ makepkg -si


$ git clone https://aur.archlinux.org/tizonia-all-git.git
$  tizonia-all
$ makepkg -si

Snap Package

NOTE: Unfortunately, the snap package is taking too much of my time to maintain, given the number of other release tasks that I need to deal with during a normal release cycle of Tizonia. So I'm calling for maintainers for the Snap package. Please see message in the Snap package repo at https://github.com/tizonia/tizonia-snap/

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

• Tizonia's landing page on Snapcraft.io

Show details

$ sudo snap install tizonia

Tizonia's snapcraft.yaml file is hosted in a separate repository:

• tizonia-snap

Docker Image

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

• docker-tizonia

Configuration

To use Spotify, Google Play Music, SoundCloud and Plex you need to introduce your credentials in Tizonia's config file. No credentials needed to stream from YouTube or TuneIn.

Show details

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

$ tizonia --help

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

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

Upgrade

Debian / Ubuntu / Raspbian

To upgrade Tizonia and all its dependencies, simply re-run the installation script.

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

Show details

$ sudo apt-get update  sudo apt-get upgrade






$ sudo -H pip3 install --upgrade gmusicapi soundcloud youtube-dl pafy pycountry titlecase pychromecast plexapi spotipy fuzzywuzzy eventlet python-Levenshtein


$ 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

Uninstall

Debian / Ubuntu / Raspbian

To uninstall Tizonia and all its dependencies, run the following commands

Show details

sudo apt-get -y remove --purge tizonia-all  sudo apt-get -y autoremove

Hall of Fame

If you are interested in participating, please read our contribution guidelines and don't hesitate to ask (via the bug tracker, chat or any other means!).

Here are some of our contributors: