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