| 1 | deejayd |
|---|
| 2 | =========== |
|---|
| 3 | |
|---|
| 4 | Actual version : 0.9.0 |
|---|
| 5 | ---------------------- |
|---|
| 6 | |
|---|
| 7 | Description: |
|---|
| 8 | ------------ |
|---|
| 9 | deejayd is an media player written in python and based on twisted. |
|---|
| 10 | So, it is a network daemon which can be controlled with a client application |
|---|
| 11 | like MPD. The protocol used to control deejayd is an XML protocol. |
|---|
| 12 | Documentation of this protocol can be found in source archive (doc directory) |
|---|
| 13 | |
|---|
| 14 | Clients: |
|---|
| 15 | -------- |
|---|
| 16 | * djc : |
|---|
| 17 | ----- |
|---|
| 18 | djc is a command line client available in this package |
|---|
| 19 | * djmote : |
|---|
| 20 | -------- |
|---|
| 21 | djmote is a graphical deejayd client optimized for use on Maemo devices |
|---|
| 22 | such as the Nokia N770 or Nokia N800. |
|---|
| 23 | For now, it does not work with deejayd >= 0.8.0 |
|---|
| 24 | * deejayd-webui : |
|---|
| 25 | -------- |
|---|
| 26 | It is a web based client written in XUL. It is replace ajaxdj and |
|---|
| 27 | it is included in deejayd. It can be configured in webui section of |
|---|
| 28 | deejayd configuration file. The first time you try to use this ui, |
|---|
| 29 | you need to download and install a firefox extension. This is needed |
|---|
| 30 | to allow extended feature (like drag and drop) without change |
|---|
| 31 | firefox configuration. |
|---|
| 32 | url to use this interface : http://host:webuiport/ |
|---|
| 33 | * mobile-webui : |
|---|
| 34 | -------- |
|---|
| 35 | It is a web based client optimized for mobile device |
|---|
| 36 | url to use this interface : http://host:webuiport/m/ |
|---|
| 37 | |
|---|
| 38 | Requirements: |
|---|
| 39 | ------------- |
|---|
| 40 | * python >= 2.4 |
|---|
| 41 | * twisted >= 2.0 (http://twistedmatrix.com/trac) |
|---|
| 42 | * simplejson (http://code.google.com/p/simplejson/), |
|---|
| 43 | it is include in python >= 2.6.0 |
|---|
| 44 | * pysqlite >= 2.2 (http://www.initd.org/tracker/pysqlite/wiki/pysqlite) |
|---|
| 45 | for sqlite database support |
|---|
| 46 | * mysql-python >= 1.2.1 (http://sourceforge.net/projects/mysql-python) |
|---|
| 47 | for mysql database support |
|---|
| 48 | * mutagen >= 1.6 |
|---|
| 49 | (http://www.sacredchao.net/quodlibet/wiki/Development/Mutagen) |
|---|
| 50 | * kaa-metadata >= 0.7.3 (http://doc.freevo.org/2.0/Kaa) |
|---|
| 51 | * lxml >= 2.0 (http://codespeak.net/lxml/) |
|---|
| 52 | * twisted-web >= 0.6.0 if you want to use deejayd-webui |
|---|
| 53 | * if you want to use gstreamer backend (audio only) |
|---|
| 54 | * pygobject >= 2.12 (http://www.pygtk.org/) |
|---|
| 55 | * gstreamer >= 0.10 (http://gstreamer.freedesktop.org) |
|---|
| 56 | * gstreamer plugins : |
|---|
| 57 | * Required : |
|---|
| 58 | * gst-python >= 0.10 |
|---|
| 59 | * Optionnal : |
|---|
| 60 | * alsa, oss, esd ... |
|---|
| 61 | * mad to play mp3 |
|---|
| 62 | * ogg to play ogg |
|---|
| 63 | * for webradio, gst-plugins-gnomevfs >= 0.10 |
|---|
| 64 | * if you want to use xine backend |
|---|
| 65 | * xine-lib >= 1.1.0 |
|---|
| 66 | * libX11, libXext |
|---|
| 67 | * ctypes >= 1.0.0 (It is include in python 2.5) |
|---|
| 68 | * pyinotify >= 0.6.0 for inotify support (http://pyinotify.sourceforge.net/) |
|---|
| 69 | |
|---|
| 70 | If you want to build deejayd (distutils distribution), you also need |
|---|
| 71 | the gettext package installed because of the usage of the msgfmt binary. |
|---|
| 72 | |
|---|
| 73 | Installation: |
|---|
| 74 | ------------- |
|---|
| 75 | Download deejayd and extract it: |
|---|
| 76 | $tar xzvf deejayd-0.9.0.tar.gz |
|---|
| 77 | |
|---|
| 78 | Then, install it with: |
|---|
| 79 | $cd deejayd-0.9.0 |
|---|
| 80 | $python setup.py build |
|---|
| 81 | $python setup.py install |
|---|
| 82 | |
|---|
| 83 | Usage: |
|---|
| 84 | ------ |
|---|
| 85 | To launch deejayd just do |
|---|
| 86 | $deejayd |
|---|
| 87 | See "deejayd --help" for more informations |
|---|
| 88 | |
|---|
| 89 | To launch djc (command line client), just do |
|---|
| 90 | $djc COMMANDS ARGS |
|---|
| 91 | See "djc --help" to see available commands |
|---|
| 92 | |
|---|
| 93 | Documentation and more informations: |
|---|
| 94 | ------------------------------------ |
|---|
| 95 | see http://mroy31.dyndns.org/~roy/projects/deejayd |
|---|
