Skip to content

juanrubio/tizonia-openmax-il

 
 

Repository files navigation

Tizonia logo

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-02-11] Tizonia v0.12.0. Chromecast support is now available for Google Play Music, YouTube, SoundCloud, and Dirble playlists and standalone HTTP radio stations (casting of Spotify and local media to be included in a future release).

✔️ [2017-12-28] Snap Package and Docker Image available.

✔️ [2017-12-17] Tizonia v0.11.0. Bug-fix release.

✔️ [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-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) 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
Download 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 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:

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

About

Cloud music player for the Linux console with support for Spotify, Google Play Music, YouTube, SoundCloud, Dirble and Chromecast.

Resources

License

Stars

Watchers

Forks

Packages

No packages published

Languages

  • C 60.6%
  • C++ 22.6%
  • M4 8.7%
  • Shell 3.3%
  • Makefile 2.4%
  • Python 2.1%
  • Other 0.3%