Skip to content

Music libraries

A music library streams your audio at full fidelity — FLAC up to 32-bit/192 kHz, plus WAV, AIFF, MP3, and DSD/SACD. High-bit-depth FLAC is decoded losslessly in the browser through a WebAudio path; everything plays through the same engine that drives the 10-band EQ, crossfade, gapless playback, loudness normalization, and synced lyrics.

This page covers how to lay out the files. To create the library, add a music root under Admin → Libraries (see Your library).

The music ingester walks configured roots and ingests any supported audio file at any depth. Tags drive metadata — folder names are only used for edition parsing and cover art fallback.

Supported layouts

All of these layouts are supported:

Music/
  Artist Name/
    Album Title/
      01 - Track Title.flac
      02 - Track Title.flac

Music/
  Artist Name/
    Album Title [Deluxe] {Remaster}/
      01 - Track Title.flac

Music/
  Compilations/
    2020-07-24 Live Set/
      01 - Intro.wav
      02 - Track.wav

Music/
  Daft Punk - Random Access Memories (2013)/
    01 - Give Life Back to Music.flac
    02 - The Game of Love.flac

Music/
  Loose Tracks/
    random-file.mp3

Supported audio formats

  • .flac, .wav, .mp3, .aiff, .aif, .dsf, .iso

Album folder naming

  • Album edition is derived from bracketed tags in the album directory name, e.g. [Deluxe], {Remaster}. Multiple bracketed tags are combined.
  • Album identity is computed from Album Artist tag + Album Title tag + album directory path. Keeping editions in separate folders avoids collisions.
  • For single top-level album folders like Artist - Album (Year), ensure tags are set. Folder names are not parsed into artist/album.

Cover art lookup

  • Embedded album art in audio files is preferred.
  • Otherwise, any .jpg, .jpeg, or .png in the album folder may be used; the most square image is chosen.

Tips for best metadata

  • Ensure tags are filled: Artist, Album Artist, Album, Title, Track Number, Disc Number, Year.
  • For multi-disc releases, set Disc Number tags rather than relying on folder names.
  • Use consistent, numeric filename prefixes (01 -) to preserve order when tags are missing.

Metadata enrichment

After ingest, artists and albums are enriched against music providers (MusicBrainz, Discogs, Last.fm) for artwork, biographies, and tags. Lyrics are fetched separately (LRCLIB + NetEase for synced lyrics, Genius for plain text). Configure which providers run per library — see Metadata plugins.

Next steps