Skip to content

capable-average/tagTonic

Folders and files

NameName
Last commit message
Last commit date

Latest commit

 

History

28 Commits
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 

Repository files navigation

tagTonic

Edit tags, pull lyrics and album art right from your terminal. Supports image rendering in terminal using Kitty Protocol ₍^. .^₎⟆

Article on dev.to

alt text

Go Version License


Core Features

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


Get Started

Requirements: Go 1.21+

Clone

# Clone and build git clone https://github.com/sk-pathak/tagTonic.git cd tagTonic

1. Build with make

make build 

2. Build without make

mkdir build go build -o tagTonic 

Run tagTonic

# Launch tui ./build/tagTonic tui 

usage gif


Some Quick Fire Commands

# 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

Commands Cheat Sheet

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


Development

make build # Compile make run # Build + launch TUI make lint # Code quality checks

License

MIT © sk-pathak

About

No description, website, or topics provided.

Resources

License

Stars

Watchers

Forks

Releases

No releases published

Packages

 
 
 

Contributors