Ecosyste.ms: Awesome
An open API service indexing awesome lists of open source software.
https://github.com/tizonia/docker-tizonia
Containerized Tizonia cloud music player.
https://github.com/tizonia/docker-tizonia
Last synced: about 1 month ago
JSON representation
Containerized Tizonia cloud music player.
- Host: GitHub
- URL: https://github.com/tizonia/docker-tizonia
- Owner: tizonia
- License: unlicense
- Created: 2017-12-29T11:09:38.000Z (almost 7 years ago)
- Default Branch: master
- Last Pushed: 2020-10-30T07:46:50.000Z (about 4 years ago)
- Last Synced: 2024-05-01T12:48:18.763Z (7 months ago)
- Language: Dockerfile
- Size: 37.1 KB
- Stars: 22
- Watchers: 6
- Forks: 8
- Open Issues: 4
-
Metadata Files:
- Readme: README.md
- License: LICENSE.md
Awesome Lists containing this project
README
[](http://microbadger.com/images/tizonia/docker-tizonia "Get your own image badge on microbadger.com")
# Tizonia on Docker container
Containerized [**Tizonia**](http://www.tizonia.org/) 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.
> Credits: Method borrowed from [docker-pulseaudio-example](https://github.com/thebiggerguy/docker-pulseaudio-example).
## Launch Command
Use the convenience script [docker-tizonia](docker-tizonia).
The script bind mounts the host's '$HOME/.config/tizonia' to make
'tizonia.conf' available inside the container.
> NOTE: The Tizonia process running inside the container needs 'rwx'
> permissions on this directory.
The script also bind mounts the host's '$HOME/.cache' to allow debug logs to be
written to disk. For example, gmusicapi logs for Google Play Music can be found
at '$HOME/.cache/gmusicapi/log/gmusicapi.log'
Once the script is in your path, and the permissions of '$HOME/.config/tizonia'
have been changed, just use the usual Tizonia commands:
``` bash
# 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"
```
## Mac Support
### Step 1)
It is required that PulseAudio to be installed via `homebrew`
(`brew install pulseaudio`), and the following lines in
`/usr/local/Cellar/pulseaudio/13.0/etc/pulse/default.pa` to be uncommented:
```
load-module module-esound-protocol-tcp
load-module module-native-protocol-tcp
```
### Step 2)
To choose the device being used for output, bring up a list of possible output devices and
select one as the default sink:
```bash
pactl list short sinks
pacmd set-default-sink n # where n is the chosen output number
```
### Step 3)
Start the Pulseaudio daemon:
```bash
pulseaudio --load=module-native-protocol-tcp --exit-idle-time=-1 --daemon
```
You should now be able to utilize the `docker-tizonia` script to route audio from the docker
container to the host machine!
# License
The [Unlicense](LICENSE.md).
# Tizonia's main repo
See [tizonia-openmax-il](https://github.com/tizonia/tizonia-openmax-il).