PUDDLETAG(1)

💖 PUDDLETAG 💖

okay bestie, welcome to puddletag, the tag editor that literally changed my life, and I'm gonna walk you through the whole puddletag(1) manual like we're texting at 2am 🦋

---

✨ NAME ✨

puddletag — it's puddletag. that's the name. iconic, no notes. 💅

---

🌸 SYNOPSIS 🌸

puddletag [options] [file/directory paths...]

like, you just run it, you can throw options at it, you can throw files and directories at it, it's giving flexible ✨

---

🎀 DESCRIPTION 🎀

so puddletag is an audio tag editor (primarily created, as the original so humbly puts it) for GNU/Linux, and it's basically the GNU/Linux twin of that Windows program Mp3tag. and here's the thing that makes it hit different: unlike most taggers on GNU/Linux, it uses a spreadsheet-like layout, so literally every tag you wanna edit by hand is just… right there. visible. easily editable. no digging. we love a transparent queen 👑

the usual tag editor features are all supported, and by usual I mean:

• extracting tag information from filenames
• renaming files based on their tags using patterns
• basic tag editing

and then there's Functions, which do stuff like replace text, trim it, do case conversions, etc. then there's Actions, which automate repetitive tasks (the way that saves you hours fr fr 😭). you can also import your QuodLibet library, and lookup tags using Amazon (cover art included!), Discogs (does cover art too!!), FreeDB and MusicBrainz. there's quite a bit more, but the original author reached their comma quota and honestly, same. 💀

Supported formats: ID3v1, ID3v2 (mp3), MP4 (mp4, m4a, etc.), VorbisComments (ogg, flac), Musepack (mpc), Monkey's Audio (.ape) and WavPack (wv). 🎧

---

✨ OPTIONS ✨

• file/directory paths... — paths to any files or directories which'll be loaded on startup. basically, hand it your files and it'll have them ready and waiting the second it opens 🫶
• -h, --help — show help message and exit. the classic. the icon. when in doubt, ask for help 💅
• --langfile=LANGFILE — path to a translation (.qm) file. if it's valid, this file'll be used to translate puddletag. otherwise the last translation chosen will be used. no cap, that's the fallback behaviour 🌈
• --fontsize=FONTSIZE — default font size to use (in points). all UI elements except the file-view will use this font size. so yes, the file-view is out here doing its own thing 🙈
• -d, --debug — show (useless) debug messages.

DO NOT USE. the manual literally says the debug messages are useless and tells you not to use it. I'm not being dramatic, I'm being accurate. step away from -d bestie 😭

---

🦋 INTEGRATION WITH CMUS 🦋

wanna launch puddletag straight from cmus, with all your marked files loaded up? yes you do. set up a keybinding like this:

bind common ^T run puddletag {}

in a configuration file such as ~/.config/cmus/rc

that's it. ^T and you're in. main character energy activated 👑✨

---

🌟 SEE ALSO 🌟

the puddletag website ( http://puddletag.sourceforge.net ) contains more info. it's also the best place to get help. go forth, read, thrive 🧚

---

puddletag Version: 0.10.4, dated April 2011 — and yeah the footer's revision line got cut off mid-word ("Revi..."), tragic, we'll never know, but shoutout to the version and the month anyway. love that for us. mwah 💖🎀💅