Bring your music anywhere

Zeya » Cookbook

This page describes various ways you can run Zeya.

If you're using the Ubuntu or Debian package, replace ./zeya.py below with zeya.

How to...

Serve music from various sources

Serve all the files within the current directory (recursively):


Serve all the files within an arbitrary directory:

./zeya.py --path=/var/music

Serve all the files in your Rhythmbox collection:

./zeya.py --backend=rhythmbox

Serve all the files specified in a .m3u or .pls playlist:

./zeya.py --backend=playlist --path=/path/to/your/playlist.m3u

Set other options

Run on a different port (default is 8080):

./zeya.py --port=9000

Serve higher-bitrate streams (default is 64kbps):

./zeya.py --bitrate=128

Only bind to a single interface (default is to bind to all interfaces):

./zeya.py --bind_address=

Require a password to access Zeya. The password configuration should be in htpasswd format.

./zeya.py --basic_auth_file=/path/to/.htpasswd

Run Zeya automatically at startup:

Zeya provides a service configuration file for Upstart-based operating systems (e.g. Ubuntu 9.10/Karmic and later).

Just copy etc/zeya.conf to /etc/init/zeya.conf and modify the last line of the file to set the options you'd like to start Zeya with, e.g.

exec python /usr/bin/zeya --path=/var/music --port=8080

Last updated: 5 October 2010