GTKPOD(1)

πŸ“¦ version 2.1.5, in debian bookworm, fedora 43, fedora 44, ubuntu jammy

✨ GTKPOD ✨

okay bestie, so you found the manual page for gtkpod β€” it lives in the gtkpod Manual section (that's section 1, the command one) and it's literally the GTK2-based software for managing songs and playlists on an Apple iPod. yes, an actual iPod. retro queen behavior. πŸ’–


🌸 NAME 🌸

gtkpod β€” GTK2 based software for managing songs and playlists on an Apple iPod πŸŽ΅πŸ‘‘


πŸ¦‹ SYNOPSIS πŸ¦‹

gtkpod [-h] [-m path] [-p filename] [--hash filename]

like, that's the whole vibe check right there. short, sweet, iconic. πŸ’…


πŸ’œ DESCRIPTION πŸ’œ

ngl this manual page is just here to briefly describe the gtkpod command. that's it, that's the job. it's giving "small but mighty". ✨


πŸŽ€ OPTIONS πŸŽ€

bestie, gtkpod supports the following options β€” and there are exactly five, so no skipping, we're doing all of them:

  • -h, --help β€” displays the help message. it's literally there to help you, so use it when you're lost. πŸ™ˆ
  • -m, --mountpoint path β€” define the mountpoint of your iPod. tell it where your iPod is living, fr fr. πŸ“
  • -p filename β€” increment playcount for file filename by one. yes, one (1). it's counting your streams like it's Spotify wrapped. πŸ”₯
  • --hash filename β€” print gtkpod hash for file filename. no cap, that's what it does. πŸ”

🌈 FILES 🌈

okay so here's where the tea gets real β€” these are the files gtkpod cares about. every single one, bestie, don't scroll past:

  • ~/.gtkpod/prefs β€” per user configuration file. and like, note: it should normally only be updated through the program itself. don't go hand-editing it, that's the rule. πŸ’…
  • /etc/gtkpod/prefs β€” global configuration file. used if no configuration file exist for the user starting gtkpod. (yes, "exist", we're keeping the original grammar, it's part of the charm.) 🌍
  • ~/.gtkpod/gtkpod.in β€” if this file exists, gtkpod will try to execute it at startup. this is done before attempting to mount the iPod directory (optional) or read the iTunesDB (optional). so like, it goes first, before the optional stuff. ✨
  • ~/.gtkpod/gtkpod.out β€” if this file exists, gtkpod will try to execute it while exiting the program. this is done after attempting to unmount the iPod directory (optional) and sending the "eject" command to the iPod (optional). so it goes last, after the optional stuff. bye bye energy. πŸ‘‹
  • /etc/gtkpod/gtkpod.in, /etc/gtkpod/gtkpod.out β€” used instead of the per user scripts if the former ones don't exist and these do. backup besties. 🫢
  • ~/.gtkpod/gtkpod.load β€” if this file exists, gtkpod will execute it before loading the contents of an iPod with the iPod's mountpoint as the only command line argument. put any commands needed to access the iPod here, for example if you need to mount the iPod manually. so like, one argument only β€” the mountpoint. that's it. πŸ“₯
  • ~/.gtkpod/gtkpod.eject β€” if this file exists, gtkpod will execute it when ejecting an iPod with the the iPod's mountpoint as the only command line argument. (yep, "the the". iconic typo, we respect it.) put any commands you want to execute after gtkpod has written the changes to the iPod here. for example:
sudo eject $1
🚨 IMPORTANT, bestie: gtkpod will not attempt to do any magic of it's own to mount/unmount/eject the iPod. so if you need that, it's your script's job. no cap. πŸ’€

πŸ‘‘ AUTHOR πŸ‘‘

say thank you to the legends:

  • Jorg Schuler <jcsjcs at users.sourceforge.net>
  • Corey Donohoe <atmos at atmos.org>
  • Adrian Ulrich <pab at blinkenlights.ch>
  • and others

and this manpage was written by Frank Lichtenheld. slay. ✍️✨


this program is free software; you can redistribute it and/or modify it under the terms of the GNU General Public License as published by the Free Software Foundation; either version 2, or (at your option) any later version. that's the whole license note, fr fr β€” free software main character energy. πŸ•ŠοΈ


and that's the whole page, bestie!! πŸŽ‰ this was gtkpod version 2.1.5, dated 2009-01-04, from the GTKPOD(1) manual. periodt. πŸ’…βœ¨