NAME

       deejayd.conf - Site-wide configuration file for deejayd, a media player daemon.

DESCRIPTION

       The file /etc/deejayd.conf is an INI like file which configures deejayd. The format looks
       like this :

           [sectionname]
           variable = value
           othervariable = othervalue

           [othersection]
           foo = bar

GENERAL SECTION

       This section defines the general section configuration values for all of deejayd
       components.

       log
           Log level. Possible values are error to log only errors, info to be more verbose and
           debug to log all messages.

       activated_modes
           Modes enabled. Available modes are : playlist for audio playlists, panel for audio
           panel mode like rhythmbox, webradio for streamed webradios, video for video
           directories playback, dvd for DVD playback. As an example :

               activated_modes = playlist, panel, webradio, video

       fullscreen
           Fullscreen video. This is mainly a debugging configuration value and you want this to
           be set to yes if you use the video mode. Set this to no if you want to be able to
           control deejayd using some graphical client on the same display.

       replaygain
           Replaygain support, yes or no.

       media_backend
           The chosen media backend. Possible values are : auto for whichever works, trying first
           with Xine, xine for the Xine backend, gstreamer for the GStreamer backend.

       enabled_plugins
           a list of plugins to activate separated by ','. Available plugins are : shoutcast to
           navigate and play shoutcast webradio audioscrobbler to activate lastfm audioscrobbler

NET SECTION

       This section defines the net section configuration values. This defines all that relates
       to the TCP XML messaging interface to deejayd.

       enabled
           Remote control using XML messages, yes or no.

       port
           The numerical TCP port number to listen on for XML messages, yes or no.

       bind_addresses
           The hostname(s), the IP address(es) of the network ipv4 interface to listen on for XML
           messages, or all to listen on all available interfaces.

               bind_addresses = localhost, 192.168.51.1, 10.2.3.4

WEBUI SECTION

       This section defines the webui section configuration values. This defines all that relates
       to the HTTP web user interface to deejayd.

       enabled
           Remote control using the HTTP web ui, yes or no.

       port
           The numerical TCP port number to listen on for HTTP request.  yes or no. You can then
           access the web ui by pointing your browser to http://deejayd-host:port/.

       bind_addresses
           The hostname(s), the IP address(es) of the network ipv4 interface to listen on for
           HTTP requests, or all to listen on all available interfaces.

               bind_addresses = 192.168.51.2, 10.0.0.3

       tmp_dir
           This is a temporary directory used by the deejayd webui for caching. It should
           probably be located in /tmp. The only use case which would involve changing this would
           be for running multiple deejayd daemons running on the same host (with both webuis
           enabled).

       refresh
           Automatic refreshing time for the webui (in seconds). This is the delay after which
           your browser will be asked to reload the web ui state (song position, current song,
           etc). Set to 0 to disable this automatic reloading.

DATABASE SECTION

       This section defines the database section configuration values. This defines all that
       relates to the internal media database used by deejayd.

       db_type
           Database backend used, among sqlite and mysql.

       db_name
           (SQLite only) The full path to the sqlite database file.

       db_user
           (MySQL only) The username to use to connect to the database.

       db_password
           (MySQL only) The password to use to connect to the database.

       db_host
           (MySQL only) The host to try to connect to to reach the database.

       db_port
           (MySQL only) The port to try to connect to to reach the database. Usually 3306.

MEDIADB SECTION

       This section defines the mediadb section configuration values. This defines all that
       relates to the relationship between you media files and deejayd and its database.

       Symlinked directories in both audio and video locations will be followed and watched if
       inotify is supported.

       music_directory
           The full path to the directory holding you music files.

       video_directory
           The full path to the directory holding you video files.

       filesystem_charset
           The character set to use to decode your filenames. This should probably be
           autodetected.

PANEL SECTION

       This section defines the panel section configuration values. Those options configure the
       behaviour of the panel mode.

       panel_tags
           Music tags that are avilable for filtering in the panel mode. Available possibilities
           are : genre,artist,album which is the default, artist,album,
           genre,various_artist,album, various_artist,album.  various_artist here is the same as
           artist, except compilation albums are grouped into a special "Various Artists" label.

           As an example :

               panel_tags = genre,artist,album

GSTREAMER SECTION

       This section defines the gstreamer section configuration values. Those options are
       specific to the GStreamer backend.

       audio_output
           The output device to use. This is usually one among auto, alsa, oss, esd, etc.

       alsa_card
           Optionnaly, the alsa card to output to, e.g.  hw:2. This is useful if you have more
           than one soundcard.

XINE SECTION

       This section defines the xine section configuration values. Those options are specific to
       the Xine backend.

       The Xine backend may be customised even more using de Xine configuration file used by
       deejayd. This is usually ~/.xine/config, ~ being to home directory of the user running
       deejayd. This should change to be /etc.

       audio_output
           The output device to use. This is usually one among auto, alsa, oss, etc.

       software_mixer
           Set to true to use xine software mixer yes or no.

       video_output
           The video driver to use. This is usually one among auto, xv, x, etc.

       video_display
           The X display to play the video to. Usually :0.0.

       osd_support
           On-screen display enabled yes or no.

       osd_font_size
           The On-screen display font size, an integer.

SEE ALSO

       deejayd(1).

AUTHOR

       This manual page was written by Alexandre Rossi <alexandre.rossi@gmail.com> for the Debian
       system (but may be used by others). Permission is granted to copy, distribute and/or
       modify this document under the terms of the GNU General Public License, Version 2 any
       later version published by the Free Software Foundation.

       On Debian systems, the complete text of the GNU General Public License can be found in
       /usr/share/common-licenses/GPL.

COPYRIGHT

       Copyright © 2008 Alexandre Rossi

[FIXME: source]                          June, 30th 2008                          DEEJAYD.CONF(5)