---
name: "gnupod_addsong"
section: "1"
platform: "linux"
package: "gnupod-tools"
version: "0.99.8+dfsg-2"
release: "Debian 13 (Trixie)"
platforms: ["linux"]
url: "https://new.carta.tech/gnupod_addsong"
---

# gnupod\_addsong(1)

manual page for gnupod\_addsong.pl 1.00

## NAME

gnupod\_addsong.pl - manual page for gnupod\_addsong.pl 1.00

## SYNOPSIS

**gnupod\_addsong.pl** \[*OPTION*\]...

## DESCRIPTION

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,  gnupod\_addsong.pl converts the FLAC files 'on-the-fly' using 'flac')

- **--help**

  display this help and exit

- **--version**

  output version information and exit

- **-m**, **--mount=DIRECTORY**

  iPod mountpoint. Default is $IPOD\_MOUNTPOINT

- **-r**, **--restore**

  Restore the iPod. Use this if your iPod is messed up. You will lose all playlists

- **-d**, **--duplicate**

  Allow duplicate files. Per default, gnupod\_addsong.pl checks for duplicate files.  Use this switch to disable the check.

- **-p**, **--playlist=NAME**

  Add songs to this playlist

- **--disable-v1**

  Do not read ID3v1 Tags

- **--disable-v2**

  Do not read ID3v2 Tags

- **--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.

- **-e**, **--reencode=INT**

  Re-encode while adding Files. 0=God / 9=Bad Quality. Lame is needed for MP3, FAAC for AAC (m4a).

- **--set-title=STRING**

  Force Title

- **--set-artist=STRING**

  Force Artist

- **--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

- **--set-playcount=INT**

  Force Playcount

- **--set-songnum**

  Order songs on the iPod in the same order as they were added (= Overwrite songnum tag)

- **--set-bookmarkable**

  Set this song as bookmarkable (= Remember position)

- **--set-shuffleskip**

  Exclude this file in shuffle-mode

- **--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

## REPORTING BUGS

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

## 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.

## 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.