Tizonia
- A command-line music streaming client/server for Linux.
- With support for Spotify, Google Play Music (including Unlimited), YouTube, SoundCloud, and Dirble.
- A multimedia framework based on OpenMAX IL 1.2.
|
|
|
Table of Contents
News
Installation
Debian / Ubuntu / Raspbian
Available from Bintray, with the following distro/arch combinations:
| Ubuntu Trusty (14.04) | Ubuntu Xenial (16.04) | Ubuntu Bionic (18.04) | Debian Jessie (8) | Raspbian Jessie (8) | Debian Stretch (9) | Raspbian Stretch (9) |
|---|---|---|---|---|---|---|
| amd64 | amd64, armhf | Coming Soon | amd64, armhf | armhf | amd64, armhf | armhf |
 |
 |
 |
 |
 |
 |
 |
NOTE: Elementary OS and Linux Mint are supported on releases based on Ubuntu 'Trusty' or Ubuntu 'Xenial'.
Please note that the recommended way to install Tizonia in a Debian-compatible system is running the following command, that installs the latest release along with all its dependencies.
$ 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: 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:
- Tizonia's landing page on Snapcraft.io or
- Tizonia on uApp Explorer
To install, first visit Install Snapd to make sure that your Linux distro is supported. Follow the instructions there 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 on this 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 Dirble, introduce your credentials in Tizonia's config file (see instructions inside the file for more information):
$ mkdir -p $HOME/.config/tizonia
$ cp /etc/tizonia/tizonia.conf $HOME/.config/tizonia/tizonia.conf
( now edit $HOME/.config/tizonia/tizonia.conf )
( NOTE: If you have installed the 'snap' package, use the following commands instead. )
$ mkdir -p $HOME/snap/tizonia/current/.config/tizonia
$ cp /var/lib/snapd/snap/tizonia/current/etc/xdg/tizonia/tizonia.conf $HOME/snap/tizonia/current/.config/tizonia
( now edit $HOME/snap/tizonia/current/.config/tizonia )
Upgrade
To upgrade Tizonia, run 'apt-get' as usual, but also make sure the Python dependencies are up-to-date.
$ sudo apt-get update && sudo apt-get upgrade
# (Note that new versions of some of these Python packages are released frequently)
$ sudo -H pip install --upgrade gmusicapi soundcloud youtube-dl pafy pycountry titlecase
Roadmap
- Chromecast support.
- YouTube live streams support.
- REPL command-line interface.
- OS X port.
Project
See PROJECT.md to learn more about this project.
Building
See BUILDING.md for instructions on how to build Tizonia from source.
Documentation
See docs.tizonia.org for the most up-to-date project documentaion.
The Wiki may also contain some useful information (although in need of an update).
Changelog
See CHANGELOG.md for details on what has gone into each release of the project.
License
Tizonia OpenMAX IL is released under the GNU Lesser General Public License version 3.
More information
For more information, please visit the project web site at http://www.tizonia.org