/tizonia-openmax-il

Cloud music player for the Linux console that supports Spotify, Google Play Music, YouTube, SoundCloud, and Dirble.

Primary LanguageCGNU Lesser General Public License v3.0LGPL-3.0

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.

Build Status | Coverity Scan Build Status | Documentation Status | Codecov | GitHub commits | Codacy Badge | CII Best Practices | license

alt text

Table of Contents

News

✔️ [2017-10-22] Tizonia v0.10.0. Bug-fix release.

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

✔️ [2017-08-04] Tizonia v0.9.0. Maintenance release that removes Deezer support due to copyright issues.

✔️ [2017-06-25] Tizonia v0.8.0 released adding support for Deezer.

✔️ [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 Trusty (14.04) Ubuntu Xenial (16.04) Debian Jessie (8) Raspbian Jessie (8) Debian Stretch (9) Raspbian Stretch (9)
amd64, armhf amd64, armhf amd64, armhf armhf amd64, armhf armhf
Download Download Download Download Download Download

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 is by running the following command, that installs in a Debian-compatible system the latest release of Tizonia 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, but basically, the script makes sure your Debian-compatible system is updated with all the necessary packages, before installing Tizonia from Bintray.

Arch User Repository (AUR)

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

    # or

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

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 )

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

Project

See PROJECT.md to learn more about this project.

Roadmap

  • Chromecast support.
  • REPL command-line interface.
  • Snap packages.
  • OS X port.

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