Edit tags, pull lyrics and album art right from your terminal. Supports image rendering in terminal using Kitty Protocol ₍^. .^₎⟆
Modern TUI – Bubble Tea + Kitty protocol artwork rendering
Batch Processing – Fast batch processing using goroutines with bulk tag editing
Smart Fetching – Auto-grab lyrics & artwork using mp3 metadata
Requirements: Go 1.21+
# Clone and build
git clone https://github.com/sk-pathak/tagTonic.git
cd tagTonicmake build
mkdir build
go build -o tagTonic
# Launch tui
./build/tagTonic tui
# Fire up the TUI
tagTonic tui
# Edit tags inline
tagTonic edit song.mp3 --title "Song Title" --artist "Artist" --album "Album"
# Auto-fetch metadata
tagTonic fetch song.mp3 --lyrics --artwork
# Batch process entire library
tagTonic batch --dir ./music --recursive --lyrics --artwork| Command | Action | Key Flags |
|---|---|---|
tui |
Launch the interactive UI | – |
edit |
Manually set tags | --title --artist --album --genre --year --lyrics --artwork |
fetch |
Auto-fetch from APIs | --lyrics --artwork --force |
batch |
Process multiple files | --dir --recursive --pattern --lyrics --artwork --force |
show |
Display current metadata | – |
Full docs → USAGE.md
make build # Compile
make run # Build + launch TUI
make lint # Code quality checksMIT © sk-pathak