GNUPOD_SEARCH(23)

✨ NAME ✨

gnupod_search.pl — literally the manual page for gnupod_search.pl 1.00, bestie 💖

---

🎀 SYNOPSIS 🎀

gnupod_search.pl [OPTION]...

---

🦋 DESCRIPTION 🦋

Okay so real talk: this thing searches and removes files. That's the whole vibe. You point it at your iPod, you tell it what you're looking for, and it goes and finds it. Slay.

• --help — display this help and exit. Iconic behaviour honestly.
• --version — output version information and exit. Short king.
• -m, --mount=DIRECTORY — the iPod mountpoint, aka where your lil music box lives on your system. Default is $IPOD_MOUNTPOINT. Set that env var and you never have to type it again. You're welcome 🫶
• -t, --title=STRING — search songs by Title.
• -a, --artist=STRING — search songs by Artist.
• -l, --album=STRING — search songs by Album.
• -i, --id=INT — search songs by ID.
• -g, --genre=STRING — search songs by Genre.
• -c, --playcount=COUNT — search songs by Playcount.
• -s, --rating=STARS — search songs by Rating. Heads up, the numbers are not the stars you're thinking of: 1 star = 20, 2 stars = 40 ... — do the math, bestie 🧮
• -R, --podcastrss=RSS — search songs by podcast-rss.
• -U, --podcastguid=GUID — search songs by podcast-guid.
• -b, --bitrate=BITRATE — search songs by Bitrate.
• -o, --match-once — Search does not need to match multiple times (like ($a || $b || $c)). Basically: any one of your filters hitting is enough. Lowkey a game changer.
• --delete — Remove (!) matched songs from the iPod. Yes the exclamation mark is in the original and no, it's not being dramatic. This is the real, actual deleting one. Triple-check your filters before you run this, fr fr 💀
• --view=ialt — Modify output, default is 'ialt'. Here's your lil legend for the letters, keep it handy:
  • t = title
  • a = artist
  • r = rating
  • p = path
  • l = album
  • g = genre
  • c = playcount
  • i = id
• --rename="KEY=VALUE" — Rename KEY into VALUE for matched songs. The glow-up option, honestly 💅

Example: Rename the Artist 'Jon Doe' into 'John Doe'

gnupod_search.pl --artist="Jon Doe" --rename="artist=John Doe"

---

👑 AUTHOR 👑

Written by Adrian Ulrich. The main character who made all this possible.

---

😭 REPORTING BUGS 😭

Report bugs to <bug-gnupod@nongnu.org>. Be nice about it, they're doing their best.

---

🌸 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. Read it and weep (or don't, because it's free software, which is also iconic).

---

🌈 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. Go off, go read it ✨

---

And that's the whole page, babe — gnupod_search.pl 1.00, dated June 2005, filed under GNUPOD_SEARCH(23). Love that for us. Byeeee 💜