MKTUNES(23)

💖 mktunes.pl — the MKTUNES(23) page but make it cute 💖

okay bestie, so this is the manual page for mktunes.pl, version 1.00. yes, we're doing this. pull up a chair, grab a strawberry 🍓, and let's get you fluent in this little tool.

---

🌸 NAME 🌸

mktunes.pl — literally the manual page for mktunes.pl 1.00. that's it, that's the name section. iconic of it tbh 👑

---

✨ SYNOPSIS ✨

mktunes.pl [OPTION]...

no notes. you give it options, it does the thing. periodt. 💅

---

🦋 DESCRIPTION 🦋

bestie. here's the whole point of this little program:

Convert GNUtunesDB.xml into iTunesDB format

that's the job. that's the assignment. it ate and left no crumbs. 🔥

and then there's the flags, which I'm gonna walk you through one by one, no skipping, because we don't do that here:

• --help — shows you this help and then dips. output help, exit. simple as.
• --version — spits out the version information and exits. quick little flex, then gone.

---

🎀 the actual options 🎀

• -m, --mount=DIRECTORY — this is your iPod mountpoint. the default is $IPOD_MOUNTPOINT, so if you already set that env var you're chillin. 🌈
• -n, --ipod-name=NAME — sets the iPod Name. this is for unlabeled iPods btw. and listen: iTunes displays this name, not the label. lowkey important distinction, don't get it twisted.
• -v, --volume=VALUE — adjusts the volume by +-VALUE%. so like, for example: --volume +5. cute little nudge up, or down, your call. 🔊
• -e, --energy — saves energy, which literally means it disables the scrolling title. your battery said thank you 🫶
• -g, --fwguid=HEXVAL — okay bestie this one is the ✨main character✨ of the options, so buckle up. this enforces the iPod serial / firewire-guid.

here's the lore: late 2007 iPod models (3gen Nano, Classic, Touch) refuse to work unless the iTunesDB has been signed with a sha1 hash. and this hash? it helps to detect corrupted databases, prevents sharing an iTunesDB between multiple iPods, and locks out non-apple software. yeah. 💀

good news though: GNUpod is able to create the required hash value if it knows the iPod's serial number. that serial is a 16 chars long hex value, such as: '000ba3100310abcf', and it should be autodetected on GNU/Linux (via /proc/bus/usb/devices) and on Solaris (via prtconf -v).

so use this switch to set the serial if the autodetection somehow fails to find the correct serial number of your iPod. 🙈

oh and also — you can specify the value in your configuration file (gnupodrc) as:

mktunes.fwguid = 000ba3100310abcf

options within options, we love a flexible queen. 💜

ngl, if you're on a late-2007 iPod and autodetect ghosted you, -g is your bestie. don't skip it.

---

👑 AUTHOR 👑

Written by Adrian Ulrich. we stan. 🫶

---

😭 REPORTING BUGS 😭

found a bug? don't suffer in silence, tell the people:

Report bugs to <bug-gnupod@nongnu.org>

fr fr, they wanna know. 📬

---

🌈 COPYRIGHT 🌈

Copyright © Adrian Ulrich

This is free software; see the source for copying conditions. There is NO warranty; not even for MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE.

like, none. zero. not even the implied ones. read the source, bestie, that's where the conditions live. 💅

---

⭐ SEE ALSO ⭐

The full documentation for gnupod is maintained as a Texinfo manual. If the info program and GNUpod are properly installed at your site, the command

info gnupod

should give you access to the complete manual. iykyk — the real deep lore lives in there. 🧚

---

and that's the whole page!! 💖

cute little sign-off for you: this is mktunes.pl version 1.00, and the page is dated June 2005. yeah, it's vintage. it's giving retro tech heirloom. and it's still out here converting your GNUtunesDB.xml into iTunesDB format like a legend. slay. 🌸✨🦋