Release / Usage notes

(From version 0.3.8)

• It doesn't preserve the original song order, i.e. the first time you use foo_dop, the song order will change.
• Doesn't merge play counts back into the DB. Doesn't support start/stop times. Resets the Shuffle's volume and shuffle status when updating the Shuffle.

(From version 0.5.6)

• Additional dependencies apply - ensure all required software/libraries are installed
• The device must first be set up with iTunes
• You need to enable “mobile device support” in foo_dop preferences
• Reading of On The Go playlists from the device are not currently supported.

(From version 0.6.5.5)

• Additional dependencies apply - ensure all required software/libraries are installed

The iPod supports the following formats:

• MP3: ID3v2 in USLT frame (UNSYNCED LYRICS field as of foobar2000 0.9.4.2)
• MP4/M4A: iTunes compatible tagging in LYRICS field

• Note that you may need to tag MP3s in foobar2000 in compatibility mode for the iPod to read the lyrics

(From version 0.3.6)

• foo_dop inputs a 16-bit PCM WAV file to the encoder via stdin. Therefore specified encoder must support input via pipes. However output through stdout is not currently supported.
• For more information on configuring conversion options please see conversion configuration

(From version 0.3.9)

• Only MP4 files supported.
• You must ensure the file is in the correct format.
• Use the MEDIA KIND metadata field to select the media type. The default for files detected as video is “Movie”. Accepted values are “Movie”, “TV Show”, “Music Video”, “Music” and “Audiobook”.
• TV Shows must have the SHOW metafield to show up on the iPod
• foo_dop will automatically scan MP4 files without a MEDIA KIND metafield to check if they have video content. If you wish, you can disable this from the advanced preferences screen.

(From version 0.4.2)

• Source script in preferences is a title formatting script that specifies the location of the album art. The location is assumed to be relative to the source file, unless it outputs a : character.

Examples:

folder.jpg

c:\artworkstore\$replace(%artist% - %album%,:,,?,,*,.).jpg

• When using title formatting to specify a path to artwork, take care to handle invalid filename characters using $replace (of course, in the same way you did so when naming your artwork)
• Artwork is added when files are sent to the iPod. The reload info command also adds artwork for files that do not have artwork and have the original path field from the dopdb.
• iTunes reloads artwork when it is determining gapless playback information. To prevent this, ensure you have gapless scanning enabled in foo_dop, as well as the option to set dummy data (0.5.9 and newer).

• It will backup your old database to the iPod_Control/iTunes/iTunesDB.dop.backup
• Please keep this backup in case anything goes wrong. If something does go wrong restore the backup by replacing the current iTunesDB with it. Keep a copy of both in case I want to look at them. If something really really goes wrong and the iPod doesn't start (unlikely, but just in case) you may have to shove it into Disk Mode to restore the backup.
• Replaygain to SoundCheck conversion: Uses the source (album or track gain) specified in preferences, using the other source as a fallback.
• The sort order of tracks in the library on your iPod may be a bit different after rewrite.

• Does not add files for which it finds an exact/identical match for on the iPod, otherwise it does
• If the file is already on the iPod drive, it will simply add it to the iPod's database. In that case, it will make no attempt to move the file anywhere - so if the path is too long, or the file path contains non-ASCII characters it will fail.
• Otherwise, files are sent to the Fxx directories, with their original filenames converted to ASCII.
• Subsongs / chapters not supported yet.

• Only supported currently if you run it on files located on the iPod. (I.e. do “Load library” and do it from that playlist)

• Sync in this case means: remove files from the iPod that are not in the files the iPod is being sync'd with; and add the files that are not present on the iPod.
• It does not involve any tracking of files that are modified locally on your computer. That means if you modify a file on your computer, re-sync the iPod, the old version will be removed from the iPod then the new version will be added (i.e. no “in-place” update). This means some info will be lost if you do this (play count,…).

• Files are matched to existing tracks using an exact match algorithm (requires identical files).
• If a playlist with the same name already exists the new playlist is renamed.

(From version 0.4.0)

This is equivalent to using 'Safely Remove Hardware'.

Note Windows Vista users should ensure they have this update installed.

(From version 0.4.0)

• This feature is not compatible with the quick scroll by letter feature in 5G iPods up to at least firmware 1.2.1.
• foo_dop automatically generates the new sort fields added in iTunes 7.1 based on this preference.

Please don't use other iPod management programs at the same time as the Manage contents command.

(From version 0.4.1)

• You must use the command on files located on the iPod (i.e. those from the Load iPod library command)
• This works for MP3 files (for which foobar2000 reports the encoder delay/padding values), iTunes AAC (MP4) files and Nero AAC (MP4) files by a recent Nero encoder
• It will not function correctly on corrupt MP3s. If you scan such a file, the iPod may not play it back correctly.
• You can check which songs have gapless data from the Browse iPod command.

(From version 0.4.6)

• It is accessible through the playlist contextmenu from the Manage contents command
• Not all fields are supported on all iPod models
• Rating is the number of stars (0-5)
• Length is in seconds
• Size is in bytes

(From version 0.6.0)

• This scans the Music folder on the iPod for tracks that are not in the iPod's database and adds them to it.

(From version 0.6.4.1)

• Requires Playback Statistics 2.1.8 or newer.
• Statistics (plays and ratings) are synchronised back to foobar2000 when you run any command that modifies the iPod (to force use 'Rewrite database'). This only works for files originally sent using the component, and currently they cannot have moved from their location at the time they were added to the iPod.
• Changes to statistics (plays and ratings) in foobar2000 are copied to the iPod when running the 'Synchronise' command.