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 usefull
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