Home

Discodune is a free and opensource (GPL / http://www.gnu.org/licenses/gpl.html) music library generator for Dune HD.
It is created using java and can run on many systems such as GNU/Linux or Micro$oft's.
It does not have any user interface for now. Maybe it will come someday !
There are 2 config files.

What does it do ?
Discodune browses the Music Folder tree and generates an output folder tree compatible with the Dune HD display specifications (dune_folder.txt) containing :

• dune_folder.txt files
• background images for Music Library, artist, Record
• artist, record and volume icons
• playlists

How do I run discodune ?

• First, download the latest version
• Check you have a Java Runtime Environment 6 installed
• Extract the zip file in a folder
• Modify config files as needed
• type in a console and in the good folder java -jar discodune.jar

Program parameters

• process-no-ui
• full-publish
• version
• verbose

Samples :

• java -jar discodune.jar (or double-click on discodune.jar) will run discodune user interface
• java -jar discodune.jar process-no-ui will run discodune in console mode, having it building (incremental).
• java -jar discodune.jar process-no-ui full-publish (new to 3.0.0) will run discodune in console mode, having it building and fully re-published.
• java -jar discodune.jar process-no-ui verbose will run discodune in console mode, having it building. Traces are printed to the output console.
• java -jar discodune.jar version displays discodune version.

Versions histority
... can be checked here : [History]

Music Folder tree pattern
For Discodune to generate the output tree, the Music Folder should be organised like this :

MusicLibrary folder/Artist folder/Record folder
or
MusicLibrary folder/Artist folder/Record folder/MusicFormat folder

Audio files can be contained either in a Record folder, Volume folder, or in MusicFormat folders

The MusicFormat folders give the possibility to have many versions of a record.For instance it allows for a record to have :

a Flac version for HIFI listening using discodune;)
an MP3 version, lighter, for mobility use

A MusicLibrary folder tree can look like this :

Music

ACDC

If you wanna blood you've got it

• Riff Raff.mp3
• Hell ain't a bad place to be.mp3
• ...

Highway to hell

MP3

• Highway to hell.mp3
• Girls got the rythm.mp3
• ...

FLAC

• Highway to hell.flac
• Girls got the rythm.flac
• ...

Live

CD1

MP3

• Thunderstruck.mp3
• Shoot to thrill.mp3
• ...

FLAC

• Thunderstruck.flac
• Shoot to thrill.flac
• ...

CD2

• Hells bells.mp3
• Are you readu.mp3
• ...

Pink Floyds

Wish you were here

• 01_Shine On You Crazy Diamond (part One).flac
• 02_Welcome To The Machine.flac
• ...

Summary
To sumarize, folder tree can be either of the following :

• MusicLibrary / Artist / Record / Track
• MusicLibrary / Artist / Record / Format / Track
• MusicLibrary / Artist / Record / Volume / Track
• MusicLibrary / Artist / Record / Volume / Format / Track

Remarks
To decide whether a record folder contains subfolders that are Formats or Volumes, discodune looks at the formats defined in the discodune.MusicFormats.properties file.
If one or more of the subfolders' name match to a key in the file, discodune considers that the record contains 1 volume and the subfolders represent the formats in it.
Otherwise the record contains Volumes.

Configuration files
Discodune is a through :
- The UI Configuration form
- configuration files
You need to modify some config to tell what you want (where are audio files, where to publish the output tree...)

These files are java properties files.

discodune.properties
This file contains the principal settings for discodune to work :

Param name	Description	Sample value
music-folder	This points to the source MusicFolder tree	/media/Musique
access-path-from-dune	Path for Dune HD to access the library base folder	smb://music\:wasmyfirstlove@192.168.20.100/music/
publish-folder	Discodune output Folder	/media/dune-hd/discodune
music-format-order	Format priority	FLAC,MP3,WMA
music-library-title	Music Library title	Discodune
image-path-artist	Default artist image(not used since 2.1.1)	images/artist.png
image-template-music-format-background	Template for the music format background(not used since 2.1.1)	images/MusicFormatBG.png
image-template-artist-background	Template for the artist background(not used since 2.1.1)	images/ArtistBG.png
image-path-record	Template for the record background(not used since 2.1.1)	images/record.png
thread-cout	Thread count used for building the library	5
skin	The publishing skin to use	default

In this file (or Configuration form), the parameters that must be change are :

• music-folder : Specify where are the audio files tree
• access-path-from-dune : the path of music-folder using a DuneHD supported protocol and specifying identification if needed
• publish-folder : Where discodune will be publish and then browsed with DuneHD.

music-format-order allows to specify wich music format discodune should publish in priority if there are many for a record.

skin is the name of the skin to use. A default skin called 'default' is built into discodune. Other skins must be stored into a subfolder of the skin folder. The name of the skin is the subfolder's name. Technical details about skins can be found there : [Skinning]

discodune.MusicFormats.properties
This configuration file allows to define the supported MusicFormat names and the attached file extensions.

discodune.MusicFolderCoverGetter.properties
This configuration file is used for the coverart recorvery for every levels (library, artist, record, volume, format).
Discodune does not get the covers from the web but in the record or music format folder.
Discodune looks in this file to know wich image file is to get for a record.

Param name	Description	Sample value
image-extensions	extensions of image files	.jpg,.jpeg,.png,.gif
file-name-contains	coverart image file name contains one of the keywords	cover,art,folder,front
file-name-not-contains	coverart image file name does not contain one of the keywords	back,reer