Free and ad-free, thanks to you. Support

Tags and covers

RustMusic reads your tags, but it can also fix them: one track, a whole album or a selection, with help from MusicBrainz and Deezer for metadata and covers.

Up to date for version 0.4.3

Documentation

Editing a track’s tags

Right-click a track, then “Edit tags”: title, artist, album, album artist, year, genre, track and disc numbers, composer and comment.

RustMusic tag editing dialog for a track
Editing a track’s tags.

The editor’s “Online” button opens “Fetch online”: search for the track on Deezer or MusicBrainz (“Source” menu), compare its values with yours, tick the ones to keep and click “Apply”. No account is needed.

Tags are written to MP3, FLAC, DSF, DFF and MP4 files (.m4a, .m4b, in AAC as well as ALAC). The blocks you don’t edit are copied over untouched, the audio is never rewritten, and writing is safe, including on a NAS. WAV, AIFF, Ogg and Opus remain read-only.

The tag workshop

The workshop fixes several tracks at once. To open it, right-click an album and choose “Edit tags” (formerly “Fix tags”), or select tracks and click “Workshop” in the selection bar. The selection bar’s “Tags” button is still there to quickly change a field shared by the selection.

The workshop is a single table, with an edit panel on the right that folds away in one click (“Edit panel” button). The header shows the album, the number of pending changes with “Revert all”, “Undo” (Ctrl+Z, with the number of steps) and “Write N files” (Ctrl+S). Nothing is written to your files until you click “Write”.

MenuTools
TagsComplete online, Clean, Number 1 to N, Cover
FilesRename files, Batch history

Each tool shows a line saying what it does. The “Tags” tools apply to the selected tracks. “Cover” puts an image on the selection and keeps the other images in each file; “Batch history” lets you review or undo past writes and renames.

Items to check

The “items to check” badge above the table lists what is missing: “Missing title, artist or album”, “Missing genre”, “Empty album artist”, or a “feat.” in the artist. Each item is fixed with one button (“Complete”, “Fill” or “Clean”), and “Show only these…” filters the table down to the tracks concerned. When everything is in order, the badge reads “Consistent tags”.

Editing in the table

  • Double-click a cell or press F2 to edit it. Enter confirms and moves down to the next row, Tab moves to the next cell (Shift to go back), Esc cancels.
  • Click to select, with Shift and Ctrl (⌘ on Mac) to extend the selection; Ctrl+A selects everything.
  • Each column has its own menu: copy the value to the selection, “Title Case”, clear, “Hide column”.
  • “Columns” picks the columns shown, and your choice is remembered. Album artist is hidden by default.

The edit panel

The panel holds the track, album and credits fields (composer, comment). A value you type applies to every selected track. A field whose values differ says so and keeps them as they are until you type something in it. A changed field can be reverted in one click, and genres already used on the album are suggested.

Complete online: MusicBrainz and Deezer

“Complete online”, in the workshop’s “Tags” menu, looks the album up on MusicBrainz or Deezer, as you prefer; the source you pick is remembered. No account is needed.

  1. 1

    Pick the edition

    The search starts on its own. Editions with as many tracks as your files come first, and the most likely one is marked “Best match”. On MusicBrainz, editions of the same album are told apart by year, country and format (“1991 · JP · CD”).

  2. 2

    Pick the fields

    “Fill the blanks” only fills empty fields and overwrites nothing. “Update everything” replaces your values with the source’s. “Custom” lets you choose by hand. For each field you see your files’ value, the source’s value and the effect (“Fills 17”, “Replaces 1”), which unfolds track by track. A badly matched file can be left out in one click.

  3. 3

    Review, then write

    The values land in the workshop as pending changes. Review them, then click “Write”.

SourceWhat it bringsLimits
MusicBrainzCommunity database, very thorough on editions and composers; 1200 px covers from the Cover Art ArchiveGenre and cover only when the community has added them; one search per second at most
DeezerGood-quality coversNo composer or lyricist, and genre at album level only

Multi-disc albums: tracks with the same number on two discs are no longer mixed up, with MusicBrainz as with Deezer, and the disc number is offered along with the other fields.

Covers and artist portraits

On import, RustMusic uses the cover embedded in the file, or a cover.jpg, folder.jpg or front.jpg file in the album folder.

  • Albums without a cover: “Fetch covers” in the library’s “Manage” menu, or Settings → Storage → “Album covers”.
  • Several tracks at once: “Cover” in the workshop’s “Tags” menu, or “Complete online” to take the MusicBrainz or Deezer cover.
  • A specific cover: right-click the album, “Change cover”, then “Import from Deezer”, “Search on Deezer” or “Choose a file”.
  • Artist portraits: downloaded automatically when you open an artist page, or all at once with “Artist portraits” in Settings → Storage.

Question not answered?

Open an issue on GitHub: every report helps improve RustMusic and this documentation.

Ask a question on GitHub