GNUPOD_ADDSONG(27)

✨ GNUPOD_ADDSONG ✨

okay bestie, welcome to gnupod_addsong.pl — it's a User Command, it lives in the GNUPOD_ADDSONG(27) corner of the manual-verse, and it's literally the thing that puts music on your iPod. sit down, hydrate, let's go 🫶

---

🌸 NAME 🌸

gnupod_addsong.pl — the manual page for gnupod_addsong.pl 1.00. that's it, that's the name, no notes 💅

---

🦋 SYNOPSIS 🦋

gnupod_addsong.pl [OPTION]...

---

💖 DESCRIPTION 💖

so like, the whole vibe of this program is: Upload Music to the iPod. iconic behavior, truly.

This Version can read MP3, AAC/ALAC (no DRM, sorry babe 💀) and PCM (aka .wav) files. and get this — it can even read FLAC files if Audio::FLAC is aviable and the --decode switch was used. the range? unmatched.

🚨 real talk though: The iPod can't play FLAC files. so in that case, gnupod_addsong.pl converts the FLAC files 'on-the-fly' using 'flac'. it's giving ✨transformative✨.

---

🎀 the options 🎀

• --help — display this help and exit. the "wait what does this do again" button, we love her 💖
• --version — output version information and exit. for when u need receipts 📜
• -m, --mount=DIRECTORY — iPod mountpoint. Default is $IPOD_MOUNTPOINT. tell it where ur iPod is chillin 😌
• -r, --restore — Restore the iPod. Use this if your iPod is messed up. You will lose all playlists. ok so this one is the nuclear option fr fr, the playlists are GONE gone 😭
• -d, --duplicate — Allow duplicate files. Per default, gnupod_addsong.pl checks for duplicate files. Use this switch to disable the check. sometimes u want the same bop twice, no judgement 🍓
• -p, --playlist=NAME — Add songs to this playlist. curate ur little world, main character energy 👑
• --disable-v1 — Do not read ID3v1 Tags. not me ignoring the old tags 💀
• --disable-v2 — Do not read ID3v2 Tags. and the new ones too, bold of u 🙈
• --decode=mp3|pcm|aac|aacbm — Convert FLAC and OGG files On-The-Fly into choosen format and add them. You need the Perl modules 'Audio::FLAC::Header' for FLAC files and 'Ogg::Vorbis::Header::PurePerl' for OGG files. Lame is needed for MP3 Output and FAAC (>= 1.24) is needed for AAC output. Btw: 'aacbm' means a Bookmark-AAC File (M4B). See --reencode to specify the quality of the output file. lowkey a whole pipeline but slay 💅
• -e, --reencode=INT — Re-encode while adding Files. 0=God / 9=Bad Quality. Lame is needed for MP3, FAAC for AAC (m4a). yeah bestie 0 is God tier, 9 is... not 🔥
• --set-title=STRING — Force Title. u decide, not the file 🎀
• --set-artist=STRING — Force Artist. manifest that name ✨
• --set-album=STRING — Force Album. 🦋
• --set-genre=STRING — Force Genre. 🎵
• --set-rating=INT — Force Rating: 0 = 0 starts / 20 = 1 star / 40 = 2 stars / 60 = 3 stars / 80 = 4 stars / 100 = 5 stars. rate it urself, be honest ⭐
• --set-playcount=INT — Force Playcount. fake it till u make it 💀
• --set-songnum — Order songs on the iPod in the same order as they were added (= Overwrite songnum tag). chronological girlies rise 🌈
• --set-bookmarkable — Set this song as bookmarkable (= Remember position). for the audiobook girlies 🎧
• --set-shuffleskip — Exclude this file in shuffle-mode. u will NOT be catching this one off guard 🙅♀️
• --set-compilation — Mark songs as being part of a compilation. 🎁
• --min-vol-adj=INT — Minimum volume adjustment done if ID3v2.4 RVA2 tags are found. Default is 0 (= Do nothing). 🔇
• --max-vol-adj=INT — Maximum volume adjustment done if ID3v2.4 RVA2 tags are found. Default is 0 (= Do nothing). Using this two options, you can adjust the volume in the range -100% to +100%. 🔉🔊

---

👑 AUTHOR 👑

Written by Adrian Ulrich. the founder, the blueprint, we stan 💜

---

🐛 REPORTING BUGS 🐛

found something cursed? Report bugs to <bug-gnupod@nongnu.org>. they wanna know, fr fr 📬

---

⚖️ 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. so like, if it breaks, that's between u and the universe 💀

---

🔭 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 read the extended lore, iykyk 📖✨

---

and that's the whole page bestie, every last crumb 🍓 — brought to u by gnupod_addsong.pl 1.00, dated April 2007, and filed under GNUPOD_ADDSONG(27). go forth and fill that iPod, ily, bye 💖🎀🦋