The Configuration Parameters

Section <gui> <window> or <fullscreen>

width
The width in pixel of the window or fullscreen.
height
The height in pixel of the window or fullscreen.
font
The fontname to display the metadata. This font has to be installed on the computer.
fontSize
The size in pixel for the font to display the metadata.
fontColor
The color for the font to display the metadata. The color has to be noted in RGB. Have a look on a RGB-Table here.
backgroundColor
The color for the background in RGB.
mouseVisible
Should the mouse cursor be displayed?
  • 0=Do not display
  • 1=Yes, show it
allwaysOnTop
On Windows-Systems only. The window stays always on top. Other windows maybe overlaid but if they have got the focus they still get the input.
lyricFont
The fontname to display the lyrics. This font has to be installed on the computer.
lyricFontSize
The size in pixel for the font to display the lyrics.
lyricFontColor
The color for the font to display the lyrics. The color has to be noted in RGB. Have a look on a RGB-Table here.
lyricFontSpace
The size in pixel for the space between lyrics and picture.
fontMarginLeft
The size in pixel for the space between metadata and the left border.
fontMarginRight
The size in pixel for the space between metadata and the right border.
fontMarginTop
The size in pixel for the space between metadata and the top border.
fontMarginBot
The size in pixel for the space between metadata and the bottom border.

top

Section <gui> <misc>

language
The language for the GUI and commandline. There has to be an INI-file with the same name in the configuration diretory. You can make up your own language file if you e.g. fill in "cockney" and create an INI-file named "cockney.ini".
showPics
How to display pictures? Possible values:
NO
Don not display pictures just show metadata
coverOnly
Only show the frontcover
allCover
Display all cover-images (Type 3-6 / Front, Back, Leaflet, Label)
allPics
Show all pictures
diaShowAllCover
Like allCover but as a slideshow
diaShowAllPics
Like allPics but as a slideshow
You can overwrite this temporary from the commandline.
diaShowTime
If slideshow: the time in seconds for each picture.
picNoCover
Which picture should be displayed if no cover is available?
fullscreen
Start dacapo always in fullscreen mode? You can overwrite this temporary from the commandline.
caption
Caption for window mode.
icon
Icon for window mode.
iconsize
Icon-size in pixel for window mode.
showComments
Display comments in dacapo? The tags for comments differ from tagging programms. dacapo is scanning for tags with comment in the name. There can be more than one comment and each comment can be multiline. It will be displayed multiline.
overlayComments
If comments are to be displayed should it overlay pictures?
shuffle
Is the playlist to be shuffled? You can overwrite this temporary from the commandline.
resume
Is the last playlist to be resumed? You can overwrite this temporary from the commandline.
showLyricsAsPics
If there are unsynchronised lyrics should it be displayed as an additional picture?
We distinguish between "unsynced-" and "synced-" lyrics. Synced lyrics have timestamps and can therefor synchronously be displayed to the music. This goes to the section <syncLyrics>. Lyrics can be displayed as additional pictures. If there are no "unsynced-" lyrics then "synced-" lyrics could also be displayed as a picture. This is meant to avoid duplicated lyrics. If you want to do this you should configure the section <syncLyrics>. The following tags are scanned:
  1. unsyncedlyrics
  2. lyrics
  3. like <syncedlyrics>
showLyricsSynced
Are synchronised lyrics to be displayed? You can overwrite this temporary from the commandline.
showSyncedLyricsAsPics
Are synchronised lyrics to be displayed as a pictures if no unsynchronised lyrics are found?
showLyricsWhenSynced
Are lyrics to be displayed as a pictures if synchronised lyrics are displayed?

top

Section <gui> <syncLyrics>

Where to look for synchronised lyrics and how to display it? (if it is to be displayed at all: showLyricsSynced)
The lyrics are searched for in this order:

  1. In the audiofile in the tag according to the config
  2. In the audiofile in the tag "syncedlyrics"
  3. In the directory according the config with the same name like the audiofile but with the ending *.lrc
  4. In the same directory and with the same name like the audiofile but with the ending *.lrc (take care of case sensitivity!)
position
The position of the lyrics on the screen.
top = above the picture (below the metadata)
bottom = below the picture (above the metadata)
style
center = align to the center
left = Left alignment
right = Right alignment
overlay
(currently not available!)
True = overlay pictures
False = descrease pitcures
tag
The tag in the audiofile which contains the lyrics in lrc-style.
dir
The directory with the lrc-file. You can use relative directories here. The lrc-file is stored with the same name like the audiofile but with the ending *.lrc. You can also use tags from the metadata here.
"." = current directory
".." = parent directory
Example:
The audiofile is stored in the directory:
/Musik/flac/AC-DC/1979 Highway To Hell/01.Highway To Hell.flac
The lrc-file is stored here:
/Musik/flac/AC-DC/Texte/1979 Highway To Hell/01.Highway To Hell.lrc
The entry "dir" should contain:
<dir typ="text"<../Texte/%date% %album%/</dir>

top

Section <gui> <metaData>

How to display metadata? Possible values are all FLAC-Tags in principle - e.g.:

  • %artist% = Song interpreter
  • %album% = Name of the album
  • %title% = Name of the song
  • %date% = Year of publication
  • %tracknumber% = The number of the track on the album
  • %tracktotal% = Total tracks on the album
  • %discnumber% = Disc number (out of ?)

additional:

  • %tracknumberlist% = Number of song out of playlist (only if playlist)
  • %tracktotallist% = Total number of songs in playlist (only if playlist)
  • %time% = current position in song (hh:mm:ss)
  • %duration% = Total duration of song (hh:mm:ss)

Furthermore, with <if_playlist> and <if_discNr> you can define additional variables, which could be used, if you play a playlist or if it is a disk of a plurality.
Example:
<bottomLeft typ="text"> %tracknumber%/%tracktotal% - %title% %if_playlist%</bottomLeft> <if_playlist typ="text"> (%tracknumberlist%/%tracktotallist%) </if_playlist>

topLeft
What to display in the upper left corner?
topRight
What to display in the upper right corner?
bottomLeft
What to display in the lower left corner?
bottomRight
What to display in the lower right corner?
if_playlist
What to display if processing a playlist?
if_discNr
What to display if processing e.g. 2 CD Set?
MP3-Tags
Generally MP3-tags are converted into the name of FLAC-tags. But you can also link MP3-tags on your own by using the name of the tag you want to use in the chapter Metadaten as parameter and the name of the MP3-tag as the value.
Example:
In topLeft I want to display the "artist", and I want it to be taken from the MP3-tag TPE1:
<artist typ="text">TPE1</artist>

top

Section <audio_engine>

GStreamer is used for the audio output. This awesome program generally supports Replay Gain and Gapless. Nonetheless there were some Ubuntu versions on which GStreamer had some problems with it. If you get in trouble somehow, the player hangs or similary, set Replay Gain and/or Gapless to False.

sinkType
alsa (on Linux)
autoaudio (on Linux or Windows)
replayGain
Use Replay Gain? (True/False)
gapless
Use gapless playback? (True/False)

top

Section <debug>

This program is writing debug informations into a textfile. The path to this file has to exist. Each time this program starts the textfile will be overwritten.

logFile
Here the information is recorded. The path must exist, the file is created.
logLevel
DEBUG,INFO,WARNING,ERROR oder CRITICAL
debugGUI
Debug-output for GUI-Module (True/False)
debugPL
DDebug-output for playlist-Module (True/False)
debugS
Debug-output for sound-Module (True/False)
debugM
Debug-output for metadata-Module (True/False)

top