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 Downloads 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 /Applications/AppleScript/Script Editor.

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:

You can restore your original settings after using the script.

To give your imported files "human readable" names, check the "Keep iTunes Music folder organized" preference box in iTunes>Preferences>Advanced>General.

Importing

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


Cavaets

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.


Credits

This script is frankensteined from Doug Adams' Import iPod Audio Files script; read its info for details on who Doug borrowed from (notably John Paul Davis' Selected Playlist to iPod).

The ProgBar app is written by T.J. Mahaffey of Spork Software.

 

DOWNLOAD iPod Music Importer 1.0