Skip to content

About

Music Tag Editor (MTE) helps you organize your music files

Resources

Contributing

Stars

0 stars

Watchers

0 watching

Forks

Repository files navigation

Music Tag Editor (mte)

CI Latest release License: MIT

A cross-platform (macOS, Linux, Windows) desktop editor that shows and edits every raw tag stored in audio files. Unlike Picard, nothing is mapped or hidden: podcast frames, PRIV, TXXX, iTunes freeform atoms, and frames mutagen can't even parse all show up.

Tag system Files What you see
ID3v2.3 / v2.4 MP3, WAV, AIFF, DSF, TTA Every frame exactly as stored, with no v2.3→v2.4 translation. Full frame-level fields: encoding, language, description, owner, picture type, MIME, raw data. Unparseable frames are shown read-only and survive saves.
ID3v1 / v1.1 MP3, TTA Shown separately, not merged into v2. Mutagen's v1 rewrite is undone, so v1 only changes when you edit it.
APEv2 MP3, APE, WavPack, Musepack, OptimFROG, TAK Every item: text (multi-value), binary, external.
MP4 atoms M4A, M4B, MP4 ©nam…, pcst/catg/purl/egid, ----:mean:name freeform, covr images, plus unparseable atoms.
Vorbis comments FLAC, Ogg Vorbis/Opus/FLAC/Speex Original key case and order, multi-values, vendor string, METADATA_BLOCK_PICTURE.
FLAC pictures FLAC Picture blocks with type, MIME, description, size and depth.
ASF WMA Attributes with their value type.

Features

  • Open a folder (recursive) or files, or drag and drop them in. Loading runs in the background.
  • Multi-select files to see the union of their tags. Rows show <n different values> and [in n/m files].
  • Edit inline (F2 / click) or in the full frame editor (double-click / Enter / Ctrl+E). In batch mode only the fields you change are written to each file.
  • Add any frame/atom/field (Ctrl+T), delete tags (Del), and Find & Remove tags whose key or value contains some text (Ctrl+Shift+F). Find & Remove is a GUI version of clean_audio_tags.py.
  • Nothing touches disk until Save (Ctrl+S). Modified rows and files are highlighted, and Revert discards changes. Failed files keep their pending edits.
  • Picture and binary data: preview, hex dump, import and export.

Download

Get the installer for your system from the latest release:

System File
macOS (Apple Silicon) MusicTagEditor-x.y.z-macos-arm64.dmg
macOS (Intel) MusicTagEditor-x.y.z-macos-x86_64.dmg
Windows MusicTagEditor-x.y.z-windows-x64-setup.exe, or the portable .zip
Ubuntu / Debian mte_x.y.z_amd64.deb (sudo apt install ./mte_*.deb, then run mte)
Other Linux MusicTagEditor-x.y.z-linux-x86_64.AppImage (chmod +x it, then run it)

The installers aren't code-signed yet:

  • macOS: the first time, right-click the app and choose Open. Or run xattr -dr com.apple.quarantine "/Applications/Music Tag Editor.app".
  • Windows: if SmartScreen warns, click More info → Run anyway.

Run from source

Requires uv.

uv sync
uv run mte                 # GUI (optionally: uv run mte /path/to/music)
uv run mte-cli dump FILE_OR_FOLDER
uv run mte-cli clean FOLDER songs.pk --dry-run
uv run pytest

Ubuntu needs Qt's xcb libraries: sudo apt install libxcb-cursor0 libxkbcommon-x11-0 libegl1.

To build an installer locally:

uv run pyinstaller packaging/mte.spec --noconfirm
packaging/macos/build_dmg.sh 0.1.0       # macOS
packaging/linux/build_linux.sh 0.1.0     # Linux (PYTHON="uv run python")

Official installers are built by the Release workflow when a version tag is pushed. See CONTRIBUTING.md.

Contributing

Bug reports, ideas and pull requests are welcome. See CONTRIBUTING.md for setup, the branch and PR workflow, and how releases work. Changes are listed in CHANGELOG.md.

Layout

src/mte/core/      Qt-free model, format adapters (formats/), session, batch save, cleaner
src/mte/ui/        PySide6 main window, folder tree, tag table, editors, dialogs
src/mte/cli.py     dump / clean command line
packaging/         PyInstaller spec, Inno Setup, AppImage/.deb, DMG scripts, icon
tests/             round-trip tests per format + headless GUI smoke tests

Known limitations

  • ID3v2.2 files are converted to v2.4 when saved, because v2.2 can't be written.
  • Complex ID3 structures (CHAP/CTOC sub-frames, SYLT, RVA2, ETCO…) are shown read-only, but they are preserved and can be deleted.
  • Raw ADTS .aac and Matroska/WebM aren't supported. WMA isn't covered by automated tests yet (there's no fixture).
  • No online lookup (MusicBrainz etc.) yet.

About

Music Tag Editor (MTE) helps you organize your music files

Resources

Contributing

Stars

0 stars

Watchers

0 watching

Forks

Releases

Packages

Contributors

Languages