Skip to main content
batch is tag for a whole album folder at once — set the artist, album, year, and cover art on every file in one pass. Title and track number are inherently per-file, so edit those individually with tag.

​
Arguments

​
string
required
Directory of audio files (.mp3, .flac, .m4a/.m4b).

​
Options

​
string
Set the artist on every file.
​
string
Set the album on every file.
​
number
Set the release year on every file.
​
string
Embed this cover art on every file, resized to fit 300x300px.
​
boolean
Only tag files directly inside the directory. By default subdirectories are searched too.
​
boolean
default:"false"
Append an invisible per-album suffix to each file’s artist tag — see tag. Off by default.
​
boolean
default:"false"
Look up title/artist/album/year on MusicBrainz for whatever’s still blank after the flags above, and its cover art via the Cover Art Archive if no cover is set. Fields you passed explicitly, or that the file already had, are never overwritten.
This is the only thing in bmux that contacts a third party — everything else runs fully offline. It’s off by default, and printing a one-line warning when you turn it on.
​
boolean
default:"false"
Show what would change without writing any files.

​
A failed file doesn’t stop the batch

Like convert and optimize, one bad file is reported and skipped — the rest of the directory still gets tagged, and the command exits non-zero only if something failed: