← Help Center

Audio Tagging Suite

Tag albums fast with CSV upload or MusicBrainz lookup, then download a ZIP or publish to the Digital Store.

What it does

  • Supports MP3, FLAC, and WAV files.
  • Writes title, artist, album, track number, and a short AI description.
  • Packages the finished album as a ZIP for download.
  • Can push completed files to R2 for Digital Store publishing.

Choose a workflow

  1. Spreadsheet mode: upload numbered files and a tracklist.csv.
  2. Lookup mode: enter artist + album and let MusicBrainz fill the track list.
  3. Publish mode: after completion, save tagged files to the Digital Store.

CSV format

At minimum, include track_num and title. Optional columns: artist, album, year.

Aliases like #, track, no, and number are also recognized for the track number column.

File naming tips

Best results come from filenames that start with the track number, such as 01 - Intro.mp3, 02 - Single.flac, or 3_title.wav.

The system uses the leading number to match files to the spreadsheet or lookup track list.

Publishing and storage

When a job finishes, you can download the ZIP immediately. If you choose to publish, the tagged files are copied to R2 and can be used in the Digital Store.

Files remain in temporary storage during processing only. They are not kept permanently unless you publish them.

Troubleshooting

  • If a file is skipped, make sure it ends in .mp3, .flac, or .wav.
  • If MusicBrainz can’t find the album, the system still completes the job using track numbers.
  • If the status page stalls, refresh it or check that Celery is running.
  • If publish fails, verify your R2 settings and that the job reached completed.
Open Audio Tagger Spreadsheet Mode Lookup Mode