Library Fundamentals

Layout

The top-level folder of the library contains the following folders:

  mp3
  var
  upload
  tools
  playlist
  xxx

mp3

The mp3 folder is the main folder where all MP3 files have been stored into. The folder is completely managed by a tool and its contents must not be modified manually. Any manual changes will get lost the next time the tool operates on the folder.

  #/
  +/
  A/
  B/
  ...
  Z/
  [Soundtrack]/
  [Story]/
  [Various]/

Inside the /mp3 folder there are single letter subdirectories A - Z, #, and +. These directories contain the single artist album with artist sort names starting with the letter of the directory. '#' contains all artists who's name starts with a number like 2raumwohnung. The '+' contains all other artist names like 'Ärzte, Die', please note that the usage of none ASCII characters in artist sort names is controversely discussed topic by the musicbrainz community and usage of such characters is not preferred. A simple example where non-ASCII characters is somewhat problematic, is for chinese artists. Using chinese characters for the artist name makes the fodlers and files hard to read or search.

There are also special subdirectories like [Soundtrack] for collections marked as soundtrack, [Story] for collections marked as audio book or spoken word, and [Various] for collections that are samplers of various artists.

/mp3/# /mp3/+ /mp3/A ... /mp3/Z

Below the single letter subdirectories there are directories per artist-sortname.

/mp3/./<artistsortname>/

<collectionname>, [Singles]/<tracknumber> <title>

/mp3/[Story]

<artistsorname>/<collectionname>/<tracknumber> - <title>

/mp3/[Soundrack]

<collectionname>/<tracknumber> - <artist> - <title>

/mp3/[Various]

<collectionname>/<tracknumber> - <artist> - <title>

upload

TODO

tools

TODO

playlist

TODO

var

TODO

xxx

TODO