Differences

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

--- dop:notes [2008/05/20 19:36] – updated 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 ======
-===== Loading the library =====
-  * Podcast playlists won't be loaded, and Smart Playlists will be loaded as normal playlists.
-===== 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 ====
-  * Pre-0.5.9: This is literally an "add file to iPod". I.e. it does not consider whether the song is already on your iPod.
+(From version 0.3.8)
-  * 0.5.9: Does not add files for which it finds an exact/identical match for on the iPod
+  * It doesn't preserve the original song order, i.e. the first time you use foo_dop, the song order will change.
-  * 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.
+  * 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.
-  * 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 =====
+==== 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
-===== About syncing files with your iPod =====
+  * The device must first be set up with iTunes
-  * 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.
+  * You need to enable "mobile device support" in foo_dop preferences
-  * 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,...).
+  * Reading of On The Go playlists from the device are not currently supported.
-===== Using the send playlists to your iPod command =====
+==== iPod Nano 5G support ====
-  * Pre-0.5.9: Files are matched to those on your iPod using metadata (ARTIST, TITLE and ALBUM fields). Therefore any track without metadata may be matched to the wrong track.
+(From version 0.6.5.5)
-  * Pre-0.5.9: If a playlist with the same name already exists its contents will be replaced with with the new playlists's contents.
+  * [[start#requirements|Additional dependencies apply]] - ensure all required software/libraries are installed
-  * 0.5.9: Files are matched to existing tracks using an exact match algorithm (requires identical files).
-  * 0.5.9: If a playlist with the same name already exists the new playlist is renamed.
-===== Using the remove playlists from your iPod =====
+===== Feature notes =====
-  * It removes the playlists only. It does not remove the files contained within from the iPod's library.
-  * Removed as of 0.5.9.x. Use ''Browse/manage iPod'' instead.
-===== 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 40: / 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 70: / 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 76: / Line 89: @@
   * foo_dop automatically generates the new sort fields added in iTunes 7.1 based on this preference.
-===== Using the Browse iPod command =====
+==== Using the Manage contents command ====
-Please don't use other iPod management programs at the same time as the Browse iPod 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 87: / 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 'Browse iPod' command
+  * 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)
@@ Line 106: / Line 108: @@
   * Size is in bytes
-===== About iPhone and iPod touch support =====
+==== About the recover orphaned files command ====
-(From version 0.5.6)
+(From version 0.6.0)
-  * You need Apple Mobile Device Support installed which comes with iTunes.
+  * This scans the Music folder on the iPod for tracks that are not in the iPod's database and adds them to it.
-  * The device must first be set up with iTunes
-  * You need to enable "mobile device support" in foo_dop preferences
+==== About synchronising Playback Statistics with the foobar2000 media library ====
-  * Reading of On The Go playlists from the device are not currently supported.
+(From version 0.6.4.1)
-  * Currently there is an issue where artwork displays semi-transparent in the Cover Flow view.
+  * Requires [[http://www.foobar2000.org/components/tag/playback+statistics|Playback Statistics 2.1.8]] or newer.
-  * Currently there seems to be an issue with the component losing connection to the device during the transfer of large files.
+  * 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.