id3v2-tui

A terminal user interface for editing ID3v2 metadata tags on MP3 files.

Features

• Browse directories and select MP3 files
• Edit track name, artist, album, and cover image
• Direct file editing mode via command line argument
• Keyboard-driven navigation

Requirements

• Go 1.25+

Build

go build -o ./build/id3v2-tui

Usage

# Interactive mode - browse files
./id3v2-tui

# Direct edit mode - edit specific file
./id3v2-tui /path/to/song.mp3

Keybindings

Key	Action
↑/↓	Navigate file list
Enter	Open directory / select file
Tab/Shift+Tab	Cycle focus between panels
Esc	Clear form fields
q	Quit

Testing

go test ./... -v

Run w/ coverage

go test ./... -coverprofile=coverage.out; go tool cover -func=coverage.out

Tests require a test/test.mp3 file for metadata operations.

Run pre-commit hooks

pre-commit run --all-files

Similar Projects

• clid - python based TUI
• id3tui - rust based TUI
• kid3 - KDE's GUI for editing ID3 tags

License

MIT