Skip to content

Latest commit

 

History

34 Commits

Folders and files

NameName
Last commit message
Last commit date
 
 
 
 
 
 
 
 
 
 
 
 
 
 

Repository files navigation

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.

Wuner editor

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 or later for building from source

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.

Acknowledgements

Wuner uses ID3TagEditor for reading and writing ID3 metadata.

License

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

About

A focused native macOS app for editing MP3 metadata before adding music to Apple Music.

Topics

Resources

Stars

1 star

Watchers

0 watching

Forks

Releases

Contributors

Languages