Skip to content
This repository has been archived by the owner on Dec 2, 2024. It is now read-only.

Adding Music

Steven Hildreth edited this page Sep 2, 2020 · 7 revisions

Adding music

Ensure you have MP3 files with proper ID3 tags setup (my blog post on this) and put a copy of them into the "Incoming" folder, then make a call to the "admin/scan/inbound/" API endpoint (this is a admin level feature in Roadie-VueJS). This scans the inbound folder, searching for additional metadata, puts found MP3 files into the "Library" folder and adds data to the database.

JSON files

You can tell Roadie what Artist to use for a folder by supplying a "roadie.artist.json" file which will then populate artist to use for the music in the folder.

{
    "name": "James"
}

Notes on Folder Structure

Roadie puts music into an opinionated structure to help organize large music collections.

Single media release:

  <storage_root>
    <artist (sort name if not set then name)>
      [<release year>] <release title>
       <track number> <track title>

Example: M:/storage/library/Hay, Colin/[1998] Transcendental Highway/02 Don't Believe You Anymore.mp3

More than single media release:

  <storage_root>
    <artist (sort name if not set then name)>
      [<release year>] <release title>
        <m media number> <track number> <track title>

Example: M:/storage/library/Dream Theater/[2013] Live At Luna Park/m002 04 On The Backs Of Angels.mp3

Audio and Meta-Data (ID3 tags) requirements

  • Every audio file must have these ID3 tags populated in order to be processed:
  1. Artist (TPE1)
  2. Release Name (aka Album Title) (TALB)
  3. Track Title (TIT2)
  4. Track Year (TYER)
  5. Track Number (TRCK)
  • All inbound music must be in MP3 format; 320 VBR 44.1k, is recommended.
  • Mp3tag is a highly recommended MP3 Tag editor.
  • MediaHuman's Audio Convertor is a highly recommended audio format convertor.

Tips

  • Release disc number (TPOS) is used to group tracks in to media release ("CD1", "CD2", etc.)
  • A track can have Track Artist (TOPE) set which overrides Album artist (TPE1).
    • This is common on compilation albums like sound tracks, various artists, and tracks with "Featuring" or "with" artist credits.

Special Artists

Sound Tracks

  • "Sound Track" artist is a special meta-artist as generally a sound track contains many contributing artists. It is important to have the TOPE set on each track of a "Sound Track" in order to get "Contributing" properly set on the track artist.
  • Any release that has the genre of "Soundtrack" set is processed like a Sound Track

Various Artists

  • "Various Artist" artist is a special meta-artist used to group compilation albums that are not associated to a single artist. An example is the "Now That's What I Call Music" series.