🎵 Music Tagger

A minimal VS Code extension to edit ID3 tags of MP3 files directly from the Explorer.

Install from Visual Studio Marketplace Install from Open VSX Registry

✨ Features

• Edit a single MP3 file and update common ID3 fields: Title, Artist, Album, Genre, Year, Track Number, and more
• Built-in audio player so you can listen while you tag; in folder mode it follows whichever file is selected
• Select a folder to load every MP3 file recursively
• Folder mode includes:
  • A summary section that shows Multiple values when tags differ across files
  • A per-file editable view so each track can be adjusted individually
  • Editing a field in the summary immediately applies that value across all loaded files
  • A file filter input for quickly narrowing large folders
• Embedded artwork preview, including a fanned cover-art stack when files in a folder carry different covers
• Long-form fields (lyrics, comments) shown as full auto-growing text areas instead of single-line inputs
• Custom TXXX tags shown individually by their own description, instead of one raw JSON blob
• Read-only Raw frame dump for inspecting the underlying ID3 data

🚀 Usage

1. In the Explorer, right-click an .mp3 file or a folder
2. Choose Music Tagger: Edit ID3 Tags
3. Edit values in the tag editor
4. Click Save

You can also run Music Tagger: Edit ID3 Tags from the Command Palette.

Music Tagger also registers as an alternate editor for .mp3 files. Right-click a file and choose Open With... → Music Tagger to open it directly without going through the context menu command.

Opening .mp3 files directly by default

By default, double-clicking an .mp3 file still opens VS Code's built-in audio player, and Music Tagger is only available via "Open With...". To make Music Tagger the default editor for .mp3 files instead, add this to your user or workspace settings.json:

"workbench.editorAssociations": {
  "*.mp3": "music-tagger.tagEditor"
}

With this set, double-clicking an .mp3 file opens the tag editor directly instead of the audio player tab. You don't lose playback either way — Music Tagger has its own built-in player. Note this only opens a single file at a time — folder-wide bulk tagging still requires the context menu command.

🔧 Extension Settings

This extension contributes no settings of its own, but honors VS Code's built-in workbench.editorAssociations setting described above.

⚠️ Known Issues

• Only MP3/ID3 workflows are currently supported
• Embedded artwork and the Raw frame dump are read-only; they aren't editable from the UI

None currently beyond the above. If you encounter any issues, please report them on GitHub.

📝 Notes

• Empty fields are written as empty tag values

Enjoy! 🎵