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 iTunes Library Lister 0.88.

To return to the Downloads page, click the Downloads button at left.

iTunes Library Lister 0.88

The iTunes Library Lister is now transformed into a full-blown application! iTLL uses Perl and the "iTunes Music Library.xml" file to quickly generate a listing of your iTunes library. The list can be output as tab-delimited text, as an HTML table, or as a complete HTML page. Artist, Album, and Track names are included by default; Track Artist, Genre, Kind, Track Rating, Track Time, and Year can optionally be added. Even the largest libraries can be listed in just a few seconds.

iTLL window at 70% size

Tracks are sorted by album artist/artist, then by album, then by track number within each album. When an Artist field differs from a filled-in Album Artist field, the (Track)Artist name can parenthetically appended to the album artist name. User-settable options include adding the extra fields mentioned above; setting limits on the length of Artist, Track Artist, Album, Genre, and Track names; setting Mac-Roman or UTF-8 as the text encoding for output; and specifying html head and tail template files for the "HTML page" listing. Settings are saved for easy re-use.

Installing iTunes Library Lister

iTLL requires OSX 10.3 or higher, on a G4, G5, or Intel Mac.

Installation is simple: just copy the application into your Applications folder, or wherever you'd like it to live. Although iTLL doesn't require an active iTunes to produce listings, you can place an alias to the app in your iTunes Scripts folder for easy access (located in Library/iTunes/Scripts in your Home folder).

No configuration is needed to run the iTunes Library Lister; all user-configurable options from the old script are now available in a Preferences drawer.

Using iTunes Library Lister

iTLL has a main window and a preferences drawer. To open and close the drawer, click on the main window's Prefs... button, or choose Preferences... from the iTunes Library Lister menu.

There are five controls in the Preferences drawer:

Listing Style:
You determine the format of your listing with the following settings:

HTML Page templates:


When the Listing Style is set to a Deluxe style, the settings on the right side the window become available for optional fields and length limits:

Length Limits:

Make Listing" button
Clicking the Make Listing button reads the user's settings and generates a listing to match those criteria. At the time of listing, all current settings will be written to the iTLL preferences file for later re-use.

Separate preferences are stored for text and HTML listing styles; switching listing style "context" (text or html) will load the appropriate settings.

"Save current settings" button
iTLL normally only saves main window settings when a listing is made. If you wish to save the current context's settings without generating a listing, click the Save current settings button just below the Listing Styles box.

"Prefs..." button
Click to open and close the Preferences drawer. The drawer can also be opened and closed with the Preferences... item in the iTunes Library Lister menu, or by pressing Cmd - ,.

More Info

iTLL does not list duplicate tracks — where more than one entry for a track exists, the first one encountered is listed. (So in this regard, iTLL is more of an Album lister than a Track lister.)

All sorting is case-insensitive, so that artists like "cEvin Key" show up where expected.

When an album features numerous track artists (as in a compilation album), its tracks will only be grouped together if an Album Artist is specified. For instance, to group all tracks from the "Peanut Butter Wolf Presents Chrome Child" album, set each track's Album Artist field to "Peanut Butter Wolf".

Table styling is provided via CSS classes for each cell: the table itself is class="itll"; the top row of the table, which displays column headers, is class="itllTitle"Artist cells have class="art"; Album cells have class="alb"; Genre cells have class="gen"; Kind cells have class="kin"; Rating cells have class="rat"; Time cells have class="tim"; Track cells have class="tra".

When importing a "head" template file for HTML Page output, iTLL attempts to set the charset declaration in the <head> section of the file. The method is to look for either the first occurrence of "charset=iso-8559-1" or "charset=utf-8" in a lowercased copy of the file's <head> section and, if the declaration doesn't match the selected Text Encoding popup selection, the original gets changed to match.

It's not very sophisticated—for instance, if the first charset declaration occurs in a comment, iTLL will happily change it ;-) If you don't like this behavior, you can turn it off with the No encoding adjustment checkbox in the Preferences drawer. Note: the built-in page templates will always use this substitution.


Copyright (c) 2008 S2_Mac. This script is released under the "MIT License" — try not to mangle it any more than I have ;-)


DOWNLOAD iTunes Library Lister 0.88