Skip to main content


The most common organization scheme for music is separation by artist and then album.

01 - Song.mp3
02 - Song.mp3

You can also separate your music into artist folders or with no folder structure at all.

01 - Song.flac
02 - Song.flac
08 - Song.ogg
09 - Song.ogg

Individual songs have no required parameters for filenames since the information will be scraped from metadata.


Albums with several discs will be fine with the metadata tags, but you can also use subfolders for the discs. The number can be appended after a space, hyphen, or directly after one of the following keywords.

  • Disc
  • Disk
  • CD
  • Vol
  • Volume
/Disc 1
01 - Song.mp3
02 - Song.mp3
/Disc 2
01 - Song.mp3
02 - Song.mp3


Images will be scraped from album or artist folders, and they can also be embedded in the music files themselves. The supported filenames are listed below for each respective image.


  • folder
  • poster
  • cover
  • default


  • clearart


Multiple backdrop images can be used to cycle through several over time. Simply append a number to the end of the filename directly after or after a hyphen.

  • backdrop
  • fanart
  • background
  • art
  • extrafanart
  • banner


  • disc
  • cdart
  • logo


  • thumb
  • landscape

File Extensions

Files with a ".mp4" file extension are not recognised as music. If the file does not contain a video change the extension to ".m4a", otherwise it is not found during a library scan.