Scroll to navigation


NAME - manual page for 1.00



Upload Music to the iPod. This Version can read MP3 AAC/ALAC (no DRM) and PCM (aka .wav) files. It can even read FLAC files if Audio::FLAC is aviable and the --decode switch was used. (Note: The iPod can't play FLAC files, in this case, converts the FLAC files 'on-the-fly' using 'flac')

display this help and exit
output version information and exit
iPod mountpoint. Default is $IPOD_MOUNTPOINT
Restore the iPod. Use this if your iPod is messed up. You will lose all playlists
Allow duplicate files. Per default, checks for duplicate files. Use this switch to disable the check.
Add songs to this playlist
Do not read ID3v1 Tags
Do not read ID3v2 Tags
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.
Re-encode while adding Files. 0=God / 9=Bad Quality. Lame is needed for MP3, FAAC for AAC (m4a).
Force Title
Force Artist
Force Album
Force Genre
Force Rating: 0 = 0 starts / 20 = 1 star / 40 = 2 stars / 60 = 3 stars / 80 = 4 stars / 100 = 5 stars
Force Playcount
Order songs on the iPod in the same order as they were added (= Overwrite songnum tag)
Set this song as bookmarkable (= Remember position)
Exclude this file in shuffle-mode
Mark songs as being part of a compilation
Minimum volume adjustment done if ID3v2.4 RVA2 tags are found. Default is 0 (= Do nothing)
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%.


Written by Adrian Ulrich


Report bugs to <>


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.


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.

April 2007 1.00