s3than/docker-tizonia repository overview

⁠Tizonia on Docker container

Containerized Tizonia⁠ cloud music player that uses the host's sound system.

⁠Audio Output

Tizonia connects as a client directly to the hosts PulseAudio server and uses its configuration/devices to output the sound. This is achieved by mapping the UNIX socket used by PulseAudio in the host into the container and configuring its use.

⁠Launch Command

Use the convenience script docker-tizonia⁠:

#!/bin/bash

USER_ID=$(id -u)
GROUP_ID=$(id -g)

docker run -it --rm \
  --volume=/run/user/${USER_ID}/pulse:/run/user/${GROUP_ID}/pulse \
  --volume="$HOME/.config/tizonia":/home/tizonia/.config/tizonia \
  --name tizonia \
  tizonia/docker-tizonia "$@"

The script bind mounts the host's '$HOME/.config/tizonia' to make 'tizonia.conf' available inside the container.

Once the script is in your path, and the permissions of '$HOME/.config/tizonia' have been changed, just use the usual Tizonia commands:

# Change Tizonia's config dir permissions
$ chmod a+wrx $HOME/.config/tizonia

# Install the wrapper script in a location in your PATH
$ sudo install docker-tizonia /usr/local/bin

# Pass the usual Tizonia commands to the wrapper
$ docker-tizonia --youtube-audio-mix-search "Queen Official"

⁠License

The Unlicense⁠.

⁠Tizonia's main repo

See tizonia-openmax-il⁠.