--- name: "deejayd.conf" section: "5" platform: "linux" package: "deejayd" version: "0.9.0-4" release: "Debian 7 (Wheezy)" platforms: ["linux"] url: "https://new.carta.tech/deejayd.conf" --- # deejayd.conf(5) Site-wide configuration file for deejayd, a media player daemon. ## 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. ## 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)](/deejayd/1.md). ## 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\