Here's the complete text for the download you were just reading about. For those that hate to read documentation, here's a link to DOWNLOAD iPod Music Importer 1.0.
To return to the Downloads page, click the button at left.
iPod Music Importer 1.0
The iPod Music Importer script imports audio files—MP3, AAC (protected and "bookmarkable"), Apple Lossless, AIFF, Wav, QuickTime and Audible (.aa)—from your iPod to iTunes. Tracks, playlists, or your entire iPod music library can be imported. iPod tracks can optionally be placed in a new iTunes playlist. Playlists can optionally be moved into a new or existing iTunes playlist folder.
The script is based on Doug Adams' Import iPod Audio Files, which simply copies selected iPod tracks into iTunes. I just added a bit more front-end logic to allow playlist and Library selection, and built another loop to accommodate the new choices. Add a little improvement to duplicate file detection, et voila.
Configuring & Installing iPod Music Importer
U.S. users can run iPod Music Importer with no configuration; users of non-U.S. systems may want to configure the script to better identify material purchased from the iTunes Store (aka "protected aac files"). To localize for your language system you'll need to add two bits to the top of the script; this will require opening the script in the AppleScript Editor application. You should be able to launch the Editor from its default location at
With the script opn in Script Editor, look for the
property k_ProtectedVariants property, and add a comma and then the word that Apple uses to indicate a file's "protected" status (the in-script example uses Italian, where the term for "protected" is "protetto") to the property's value. Next, add a comma and then your ISO country code to the
property k_ISOList property's value.
If your localization imposes non-U.S. file extensions on audio files, you made also need to replace the U.S. versions in
k_FileExtensions to match your own....
Installation is simple: just copy the script into your iTunes Scripts folder, located in
Library/iTunes/Scripts in your
Home folder. If there is no folder named "Scripts" there, create one and put the script inside it. The script can be then be activated by selecting it from the iTunes Script menu.
The download also contains the ProgBar application, an AppleScript Studio applet that provides a thermometer display to show you import progress. If you would like to use ProgBar (there's no requirement to do so, but no reason to stay away from it), copy it into your iTunes Scripts folder, as above.
Using iPod Music Importer
Your iPod will need to be in "manual" mode to use this script. If you auto-sync your iPod, make these changes:
- Connect your iPod to iTunes;
- Select your iPod in the iTunes Source column and click the Summary tab in the main portion of the iTunes window;
- Check the "Manually manage songs and playlists" box and the "Enable disk usage" box;
- Click the Apply button.
To give your imported files "human readable" names, check the "Keep iTunes Music folder organized" preference box in iTunes>Preferences>Advanced>General.
- To import some tracks from your iPod, select those tracks.
- To import an iPod playlist, select that playlist in the iTunes "Source" column.
- To import your iPod's entire music collection, select the "Music" playlist in the iTunes "Source" column.
- To import multiple iPod playlists, select your iPod's icon in the iTunes "Source" column.
After making a selection, activate the script from the iTunes Script menu. A dialog will confirm your choice, also offering a More Options... button; clicking this button presents a list of every non-smart music playlist on your iPod, with the currently selected playlist highlighted. You can select any number of playlists to import from this list; select no playlists to import them all. Pressing the Cancel button quits the script.
If you selected individual tracks or your Music playlist, a text entry dialog will offer to create a new iTunes playlist for those tracks; only a unique playlist name will be accepted. Leave the text entry box blank to skip copying to a playlist, or press the Skip button.
If you are creating a new iTunes playlist, or if you selected one or more iPod playlists to import, a dialog will offer to move those playlists into a new, or existing, iTunes folder playlist. To skip moving playlists into a folder, press the Skip button. If you press the New button, a text entry dialog will prompt you for a unique name for the new folder playlist; leave the text entry box blank to skip this option, or press the Skip button. If you press the Existing button at the initial prompt, a list of all iTunes folder playlists will be presented; you can choose one of these folders, or press the Skip button to skip this option.
A final dialog will summarize the number of tracks and playlists to import, along with your playlist and folder options. To back out of importing and quit the script, press the Cancel button.
If you pressed Import in the summary dialog, files will start copying from your iPod into your iTunes Music folder; they will be placed in Artist > Album sub-folders. They will then be added to your iTunes library, and placed in playlists (if appropriate). All ID3 tags will be transferred with the file, along with Play Count, Last Played Date, Skip Count, Last Skipped Date, Rating, Skip When Shuffling and Gapless Album information. (Depending on the version of iTunes being used, some info may be excluded.) Embedded album art will transfer with the files.
To prevent duplication of files, the script checks the main iTunes library for existing tracks sharing the same file size, artist name and album name; as well, the track's file must not be missing. If an iPod track shares these criteria with an iTunes track, the track's iPod file will not be copied to the Mac; the track will be added to its imported playlist (if any).
- The script will only work with Mac-formatted iPods.
- The script does not calculate the total size of files to import, nor does it determine how much space is available on the destination disk. Not liking to abuse my system, I have not tested what happens when the script attempts to copy "too many" files onto a Mac....
- Users of non-U.S. Systems or non-U.S. time Formats: see the International Localizations section, below.
- Make sure your iPod Options/Preferences are set to "Manually manage songs and playlists". Otherwise, your iPod tracks will appear grayed-out and you won't be able to select them or copy them.
- Recent iPod software changes the file names on your iPod to some seemingly-random four-character sequence, such as
YHIF.mp3. Make sure your iPod Options/Preferences are set to "Keep iTunes Music folder organized" as this will give the files a human-readable name based on each song's title.
- The script attempts to uniquely identify a track's file on the iPod by using (up to) two passes of the Unix
findcommand, based on file size, extension, and modified time. However,
findis built to identify time ranges rather than exact times; the result is that when same-size iPod files have mod times within a minute of each other, the script will not be sure which file to associate with a track.
In these cases, a dialog will ask you to select a single file for importing; most likely, the file you want is at the top of the displayed list.
- When selecting a smart playlist for importing, be aware that the script will copy only the list's tracks; the smart criteria will not be copied (such a task is well beyond the reach of a simple script; or, at least, beyond the reach of this simple scripter ;-). If you need to "copy" an iPod's smart playlists, just take screenshots of them from iTunes.
- The More Options... list of iPod playlists does not include smart playlists; if you want to import the tracks of smart playlists, you must do so one smart-list at a time.
- User-supplied "Sort" field information does not transfer from the iPod to iTunes.
Issues with non-U.S. localizations
the script currently uses US time formats to determine the "Date Modified" of the selected tracks. If files are not being imported correctly, you may have to temporarily change your time-format in the "Formats" section of the "International" System Preferences to "United States" Region.