Skip to main content
jCoderZ.org / Java tooling collective
  1. Home
  2. m3dditieZ
  3. Wiki
  4. Library fundamentals

m3dditieZ wiki / last edited 09 November 2011

Library fundamentals

The folder layout that makes an MP3 library readable without special software.

The library layout is the part of m3dditieZ that everything else depends on. Instead of hiding a music collection inside an application database, the collection is arranged as a folder tree that any file manager can read.

The principle

Metadata is the source of truth. A tagger writes artist, album, track number and related fields into the MP3 files. The m3dditieZ tool chain reads that metadata and creates or updates a folder tree in which each file sits at a predictable path.

Because the path is derived from metadata, two people with the same collection end up with the same layout. Because the path is visible in the file system, a listener can find a track without opening a special application.

Why not a database

A database is convenient until it is lost, moved or locked by a vendor. A folder tree survives a disk copy, a network share and an old operating system. The project chose the layout that is most portable rather than the layout that is most compact.

Running the tool again

When metadata changes, the tool is run again. Files that moved are placed at their new path, and files whose metadata stayed the same are left alone. The archive does not record the implementation of that step, but the project overview describes it as automatic.

What the archive keeps

Recorded scope The original page was listed in the project index but its full body was not preserved. This page keeps the layout principle that the project overview describes and does not invent folder names or command syntax that the archive did not record.

For the software that consumes the layout, see the player and the server.

References