Wuner

A focused native macOS editor for MP3 metadata, artwork and lyrics.

Wuner was built as an alternative to MP3 metadata editors centered around batch workflows, large libraries, and dense table-based interfaces. It takes a deliberately simpler approach: open one MP3, fix its metadata, artwork and lyrics, save it safely, and move on.

Status

Wuner is currently in beta. It is usable for focused single-file MP3 metadata editing, but the test fixture coverage and release process are still maturing. Keep backups of important audio files before editing them.

Features

• Edit common MP3 metadata
• View and edit embedded lyrics
• Replace, remove, or drag-and-drop album artwork
• Open MP3 files from Finder, the Dock, drag and drop, or ⌘O
• Native macOS interface and keyboard shortcuts
• Inline metadata validation
• Unsaved-change protection
• Safe file replacement when saving

Usage

Open an MP3 by dragging it into Wuner, clicking the drop area, pressing ⌘O, choosing File → Open…, using File → Open Recent, choosing Open With → Wuner in Finder, or dropping it onto Wuner in the Dock.

Edit the metadata and press ⌘S to save.

Wuner warns before opening or closing a track with unsaved changes.

Shortcuts

Shortcut	Action
⌘O	Open MP3
⌘S	Save
⌘⌫	Close current track

Saving

Wuner writes a fresh ID3v2.3 tag while preserving the MP3 audio data.

Changes are written to a temporary file and verified before the original file is replaced. If saving fails, the original MP3 is left untouched.

Metadata

Wuner reads and writes:

ID3 Frame	Field
TIT2	Title
TPE1	Artist
TALB	Album
TPE2	Album Artist
TYER	Year
TRCK	Track Number
TCON	Genre
USLT	Lyrics
APIC	Artwork

Requirements

• macOS 26.5 or later
• Xcode 26.6 or later for building from source
• Swift Package Manager access to resolve ID3TagEditor

Building

Wuner is built natively for macOS using Swift and SwiftUI.

Clone the repository:

git clone https://github.com/guiroquue/Wuner.git
cd Wuner

Open Wuner.xcodeproj in Xcode and run the Wuner target.

From the command line:

xcodebuild build -project Wuner.xcodeproj -scheme Wuner -destination 'platform=macOS'

Run tests:

xcodebuild test -project Wuner.xcodeproj -scheme Wuner -destination 'platform=macOS'

Documentation

• Architecture

Acknowledgements

Wuner uses ID3TagEditor for reading and writing ID3 metadata.

License

Wuner is available under the MIT License. See LICENSE for details.