• A music player and audio streaming client/server for Linux.
• With support for Spotify, Google Play Music (including Unlimited), SoundCloud and Dirble.
• A multimedia framework based on OpenMAX IL 1.2 provisional specification.

| |

To install the latest release:

    $ 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 installs the latest version of Tizonia's Debian packages from Bintray and all their dependencies.

Finally, 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):

    $HOME/.config/tizonia/tizonia.conf

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

Ubuntu Trusty (14.04)	Ubuntu Xenial (16.04)	Debian Jessie (8)	Raspbian Jessie (8)
amd64, i386, armhf	amd64, i386, armhf	amd64, i386, armhf	armhf

• Stream audio from Spotify (Spotify Premium required).
• Stream audio from Google Play Music (including Unlimited features).
• Stream audio from SoundCloud.
• Search and stream Internet radio stations with Dirble.
• Playback of local media files (mp3, mp2, mpa, m2a, aac, ogg/vorbis, opus, wav, aiff, and flac).
• Icecast/SHOUTcast streaming LAN server (mp3).
• Icecast/SHOUTcast streaming client (mp3, aac, and opus).
• Daemon and command line modes (no GUI).
• MPRIS D-BUS v2 media player remote control interface (basic controls only).
• Based on Tizonia's own OpenMAX IL-based multimedia framework. That means, no gstreamer, libav, or ffmpeg dependencies.

1. 'libtizonia' : OpenMAX IL 1.2 component framework

• A C library for creating OpenMAX IL 1.2 plugins (encoders, decoders, parsers, sinks, etc, for audio/video/other).
• Full support for OpenMAX IL 1.2 Base and Interop profiles.

2. 'libtizcore' : OpenMAX IL 1.2 Core implementation

• A C library for discovery and dynamic loading of OpenMAX IL 1.2 plugins.
• Support for all of the OMX IL 1.2 standard Core APIs, including OMX_SetupTunnel and OMX_TeardownTunnel.

3. 'libtizplatform' : OS abstraction/utility library

• A C library with wrappers and utilities for:
  • memory allocation,
  • threading and synchronization primitives,
  • evented I/O (via libev)
  • FIFO and priority queues,
  • dynamic arrays,
  • associative arrays,
  • small object allocation,
  • config file parsing,
  • HTTP parser,
  • uuids,
  • etc..

4. OpenMAX IL 1.2 Resource Management (RM) framework

• 'tizrmd' : a D-Bus-based Resource Manager daemon server.
• 'libtizrmproxy' : a C client library to interface with the RM daemon.

5. OpenMAX IL 1.2 codecs/plugins

• Spotify streaming service client (libspotify),
• Google Play Music streaming service client (based on 'gmusicapi' Python module + libcurl)
• SoundCloud streaming service client (based on 'soundcloud' Python module + libcurl)
• Dirble internet radio station directory (Dirble REST API + libcurl)
• mp3 decoders (libmad and libmpg123),
• mpeg audio (mp2) decoder (libmpg123),
• Sampled sound formats decoder (various pcm formats, including wav, etc, based on libsndfile)
• AAC decoder (libfaad),
• OPUS decoders (libopus and libopusfile)
• FLAC decoder (libflac)
• VORBIS decoder (libfishsound)
• PCM renderers (ALSA and Pulseaudio)
• OGG demuxer (liboggz)
• HTTP renderer (i.e. ala icecast, for LAN streaming)
• HTTP source (based on libcurl)
• mp3 encoder (based on LAME),
• a VP8 video decoder (libvpx),
• a YUV video renderer (libsdl)
• general purpose plugins, like binary file readers and writers
• etc...

• Test execution framework to build and test arbitrary OpenMAX IL graphs (tunneled and non-tunneled) using a custom, easy-to-write XML syntax.
• Skema's Github repo: http://github.com/tizonia/skema

To build and install from source, follow the these steps (Ubuntu 14.04 is assumed, but should work on other relatively recent debian-based distros).

To install all the development dependencies, the easiest way is to use the 'tizonia-dev-build' script. This script lives under the 'tools' folder and maintains an up-to-date list of all the packages that are required in a Debian-compatible system to be able to build Tizonia from source.

NOTE: The following command also installs Mopidy's 'libspotify-dev' package, and the 'gmusicapi' and 'soundcloud' python packages.

    $ cd tools
    $ ./tizonia-dev-build --deps

NOTE: libspotify-dev will be installed by 'tizonia-dev-build --deps', including the addition of Mopidy's APT archive. However, these instructions are left here for reference.

libspotify-dev needs to be present in the system. It can be installed from Mopidy APT archive, like this:

    $ wget -q -O - http://apt.mopidy.com/mopidy.gpg | sudo apt-key add - \
        && echo "deb http://apt.mopidy.com/ stable main contrib non-free" | sudo tee -a /etc/apt/sources.list \
        && echo "deb-src http://apt.mopidy.com/ stable main contrib non-free" | sudo tee -a /etc/apt/sources.list \
        && sudo apt-get update \
        && sudo apt-get install libspotify12 libspotify-dev -qq

NOTE: 'gmusicapi' will be installed by 'tizonia-dev-build --deps'. However, these instructions are left here for reference.

To stream from Google Play Music, Simon Weber's gmusicapi python library needs to be installed.

    $ sudo pip install gmusicapi

NOTE: 'soundcloud' will be installed by 'tizonia-dev-build --deps'. However, these instructions are left here for reference.

To stream from SoundCloud, the official SoundCloud Python wrapper needs to be installed.

    $ sudo pip install soundcloud

From the top of Tizonia's repo, do:

    $ autoreconf -ifs
    $ ./configure
    $ make
    $ make install

This will configure, build and install the Tizonia OpenMAX IL framework, the IL plugins and the 'tizonia' command-line player application.

Copy tizonia.conf into the user's config folder:

    $ mkdir -p $HOME/.config/tizonia \
        && cp config/src/tizonia.conf $HOME/.config/tizonia

OpenMAX IL Resource Management is present but disabled by default. In case this is to be used (prior to that, needs to be explicitly enabled in tizonia.conf), copy the Resource Manager's D-BUS activation file to some place where it can be found by the DBUS services. E.g:

    $ mkdir -p ~/.local/share/dbus-1/services \
        && cp rm/tizrmd/dbus/com.aratelia.tiz.rm.service ~/.local/share/dbus-1/services

The tizonia player app makes heavy use the the the Boost Meta State Machine (MSM) library by Christophe Henry (MSM is in turn based on Boost MPL).

MSM is used to generate a number of state machines that control the tunneled OpenMAX IL components for the various playback uses cases. The state machines are quite large and MSM is known for not being easy on the compilers. Building tizonia requires quite a bit of RAM (~2.5 GB).

You may see GCC crashing like below; simply keep running make -j1 or make -j1 install until the application is fully built (it will finish eventually, given the sufficient amount RAM).

Making all in src
  CXX      tizonia-tizplayapp.o
  CXX      tizonia-main.o
  CXX      tizonia-tizomxutil.o
  CXX      tizonia-tizprogramopts.o
  CXX      tizonia-tizgraphutil.o
  CXX      tizonia-tizgraphcback.o
  CXX      tizonia-tizprobe.o
  CXX      tizonia-tizdaemon.o
  CXX      tizonia-tizplaylist.o
  CXX      tizonia-tizgraphfactory.o
  CXX      tizonia-tizgraphmgrcmd.o
  CXX      tizonia-tizgraphmgrops.o
  CXX      tizonia-tizgraphmgrfsm.o
  CXX      tizonia-tizgraphmgr.o
  CXX      tizonia-tizdecgraphmgr.o
g++: internal compiler error: Killed (program cc1plus)
Please submit a full bug report,
with preprocessed source if appropriate.
See <file:///usr/share/doc/gcc-4.8/README.Bugs> for instructions.
make[2]: *** [tizonia-tizplayapp.o] Error 4
make[2]: *** Waiting for unfinished jobs....
g++: internal compiler error: Killed (program cc1plus)
Please submit a full bug report,
with preprocessed source if appropriate.
See <file:///usr/share/doc/gcc-4.8/README.Bugs> for instructions.

Tizonia OpenMAX IL is released under the GNU Lesser General Public License version 3.

For more information, please visit the project web site at http://www.tizonia.org