================================================================== zukebox: Juke Box

ZukeBox is a very simple "Juke Box" application for playing music from Youtube.

Project goals:

• RESTful API for adding tracks, controlling the playback
• The tracks are downloaded with youtube-dl and cached on disk
• The playback is done with python-vlc
• Browser extensions

It is in POC phase, use it own your own risk. Currently no automated tests, many things are not configurable yet, the project is in early stage.

Developing

$ python bootstrap.py
$ export PATH=$PWD/bin:$PATH
$ buildout
$ zukebox

Installation

The easiest way to install most Python packages is via easy_install or pip::

$ easy_install zukebox

Usage

Start zukebox application and use the REST api.

Adding a track::

$ http POST 0.0.0.0:5000/player/tracks url="https://www.youtube.com/watch?v=lWqeHVOQa58" user="Tomi"

Getting the tracks::

$ http GET 0.0.0.0:5000/player/tracks

Remove a track::

$ http DELETE 0.0.0.0:5000/player/tracks/0

Getting the recent tracks::

$ http GET 0.0.0.0:5000/player/recent-tracks

Control the player::

$ http PATCH 0.0.0.0:5000/player/control time=240 # seek
$ http PATCH 0.0.0.0:5000/player/control playing=false # play/pause
$ http PATCH 0.0.0.0:5000/player/control volume=50 # change volume

Copyright & License

• Copyright 2015, Tamas Domok
• License: MIT