Differences

This shows you the differences between two versions of the page.

--- dop:notes [2008/07/03 16:38] – musicmusic
+++ dop:notes [2013/08/17 20:01] (current) – Update link to "Playback Statistics" at foobar2000's components page. spamkiller
@@ Line 1: / Line 1: @@
 ====== Release / Usage notes ======
-===== About operations that modify the iPod database =====
+===== Specific devices notes =====
-  * 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 [[http://docs.info.apple.com/article.html?artnum=93651|Disk Mode]] to restore the backup.
-  * Replaygain to SoundCheck conversion: Uses album gain if present, otherwise track gain.
-  * The sort order of tracks in the library on your iPod may be a bit different after rewrite.
-===== Using the send files to iPod command =====
+==== iPod Shuffle support ====
-  * Does not add files for which it finds an exact/identical match for on the iPod, otherwise it does
+(From version 0.3.8)
-  * 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.
+  * It doesn't preserve the original song order, i.e. the first time you use foo_dop, the song order will change.
-  * Otherwise, files are sent to the Fxx directories, with their original filenames converted to ASCII.
+  * 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.
-  * Subsongs / chapters not supported yet.
-===== Using the remove files command =====
+==== iPhone and iPod touch support ====
-  * Only supported currently if you run it on files located on the iPod. (I.e. do "Load library" and do it from that playlist)
+(From version 0.5.6)
+  * [[start#requirements|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.
-===== About syncing files with your iPod =====
+==== iPod Nano 5G support ====
-  * 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.
+(From version 0.6.5.5)
-  * 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,...).
+  * [[start#requirements|Additional dependencies apply]] - ensure all required software/libraries are installed
-===== Using the send playlists to your iPod command =====
+===== Feature notes =====
-  * 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.
-===== iPod lyrics support =====
+==== iPod lyrics support ====
 The iPod supports the following formats:
   * MP3: ID3v2 in ''USLT'' frame (''UNSYNCED LYRICS'' field as of foobar2000 0.9.4.2)
@@ Line 31: / Line 28: @@
   * Note that you may need to tag MP3s in foobar2000 in compatibility mode for the iPod to read the lyrics
-===== Unsupported format conversion =====
+==== Unsupported format conversion ====
 (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.
-Configuration:
+  * For more information on configuring conversion options please see [[.config:conversion|conversion configuration]]
-  * The command to execute must be entered in the "Command" field. Use %d for the destination file parameter. Examples:<code>LAME -S --noreplaygain -V 5 --vbr-new - %d</code><code>neroAacEnc.exe -q 0.40 -ignorelength -if - -of %d</code>
-  * Enter the file extension of the target file format in the "Extension" field. E.g. ''MP3'', ''M4A''
-===== iPod Shuffle support =====
+==== Video support ====
-(From version 0.3.8)
-  * I don't own a Shuffle. Therefore I don't know if it even works or just send Shuffles into Oblivion.
-  * Make sure you backup your iPod_Control\iTunes folder before use
-  * It doesn't preserve the original song order. I.e., first time you use foo_dop, the song order will change. In addition, songs sent using foo_dop will appear in an arbitrary order.
-  * 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.
-  * Don't know how foo_dop and DRM'd songs already on the Shuffle mix.
-===== Video support =====
 (From version 0.3.9)
   * Only MP4 files supported.
   * You must ensure the file is in the [[.ipod_video|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" and "Music".
+  * 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 TYPE'' metafield to check if they have video content. If you wish, you can disable this from the advanced preferences screen.
+  * 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.
-===== Ejecting the iPod =====
+==== Album art support ====
+(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:
+<code tagz>folder.jpg</code>
+<code tagz>c:\artworkstore\$replace(%artist% - %album%,:,,?,,*,.).jpg</code>
+  * 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).
+===== Specific commands =====
+==== About commands that modify the iPod database ====
+  * 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 [[http://docs.info.apple.com/article.html?artnum=93651|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.
+==== Using the send files to iPod command ====
+  * 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.
+==== Using the remove files command ====
+  * Only supported currently if you run it on files located on the iPod. (I.e. do "Load library" and do it from that playlist)
+==== About syncing files with your iPod ====
+  * 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,...).
+==== Using the send playlists to your iPod command ====
+  * 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.
+==== Ejecting the iPod ====
 (From version 0.4.0)
@@ Line 61: / Line 83: @@
 Note Windows Vista users should ensure they have [[http://support.microsoft.com/kb/933824/|this update]] installed.
-===== Using the "Omit leading The when sorting on the iPod" option =====
+==== Using the "Omit leading The when sorting on the iPod" option ====
 (From version 0.4.0)
@@ Line 67: / Line 89: @@
   * foo_dop automatically generates the new sort fields added in iTunes 7.1 based on this preference.
-===== Using the Manage contents command =====
+==== Using the Manage contents command ====
 Please don't use other iPod management programs at the same time as the Manage contents command.
-===== Using the Determine gapless info command =====
+==== Using the Determine gapless info command ====
 (From version 0.4.1)
@@ Line 78: / Line 100: @@
   * You can check which songs have gapless data from the Browse iPod command.
-===== About album art support =====
+==== About the Smart Playlist Editor ====
-(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:
-<code tagz>folder.jpg</code>
-<code tagz>c:\artworkstore\$replace(%artist% - %album%,:,,?,,*,.).jpg</code>
-  * 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).
-===== About the Smart Playlist Editor =====
 (From version 0.4.6)
   * It is accessible through the playlist contextmenu from the ''Manage contents'' command
@@ Line 97: / Line 108: @@
   * Size is in bytes
-===== About iPhone and iPod touch support =====
+==== About the recover orphaned files command ====
-(From version 0.5.6)
-  * You need Apple Mobile Device Support and Quicktime installed which both come with iTunes.
-  * 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.
-  * Currently there seems to be an issue with the component losing connection to the device during the transfer of large files.
-===== About the recover orphaned files command =====
 (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.
+==== About synchronising Playback Statistics with the foobar2000 media library ====
+(From version 0.6.4.1)
+  * Requires [[http://www.foobar2000.org/components/tag/playback+statistics|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.