tunes2html is a Perl script that reads the data from an iPod's iTunesDB file and generates an HTML file and a text file, each containing an organized list of the songs and playlists on the iPod. can be run using Perl or, on Windows, using the tunes2html executable. The script should work on any platform that has Perl 5.005 or greater. The script requires an iTunesDB file, which is readily available on Windows and Linux systems to which an iPod has been connected. Access to the iTunesDB file on Macintosh seems to be limited to Mac OS X. has been tested on Windows 98, Windows 2000 Professional, Windows ME, Windows XP, Linux, Mac OS X, Solaris 5.7, and Solaris 5.8, using Perl 5.005 and Perl 6.

tunes2html works with iPod 3.x and iTunes 7.x & earlier versions of iPod/iTunes.

NOW AVAILABLE - tunes2html for iTunes!

tunes2html no longer confuses albums with the same name!

Download the latest version of tunes2html.

Enter your e-mail address to be notified when a new version is released. It will be used only for tunes2html notifications.

If you find tunes2html really useful, please consider using PayPal (safe and secure) to make a donation. Any size donation is really appreciated!

Update for v. 5.3

Update for v. 5.2

Update for v. 5.1

Update for v. 5.0

Update for v. 4.0.2

Update for v. 4.0.1

Update for v. 4.0

Update for v. 3.0

Update for v. 2.2

Update for v. 2.1

Update for v. 2.0

Update for v. 1.1

Working on:

tunes2html's output is visible in two sample files included in the bundle:

As you can see in the samples, there are three sections in the output - "single artists" (one artist per CD), "various artists" (two or more artists per CD), and "playlists".

The tunes2html ZIP file contains:

Always use this script on a copy of the iTunesDB file!

0. Uncompress the ZIP file into a directory. (First use only.)
1. Connect an iPod to your computer.
2. Edit the configuration file to specify the location where you'll put the iTunesDB file and where you want the output files. The default is the directory in which you have uncompressed the ZIP file. 3. Copy the iTunesDB file from the iPod_Control/iTunes directory (which may be hidden) on your iPod to the directory that you specified. (See copying instructions below.) 4a.Windows users: double-click tunes2html.exe.
4b.Perl users on any platform: run from command line as perl
5. Two files will be built: iPod.htm and iPod.txt. Both will be in the location specified in the configuration file.
6. If there is a problem with file creation or reading the iTunesDB, the program will print an error message.

How to get a copy of iTunesDB from your iPod:

  1. Connect your iPod to your computer.
  2. Open Windows Explorer, making sure Explorer is set to "Show hidden files and folders".
  3. In Windows Explorer, go to the disk letter for the iPod.
  4. Open the folder called iPod_Control.
  5. In the iPod_Control folder will be a folder called iTunes. Open it.
  6. In the iTunes folder will be a file called iTunesDB.
  7. Right-click the iTunesDB file and choose Copy.
  8. Go to the directory in which you installed the script, right-click, and choose Paste.
Mac OS X:
  1. Connect your iPod to your computer.
  2. In the Finder, Go > Utilities to open the Utilities folder.
  3. In the Utilities folder, double-click Terminal.
  4. In the Terminal window, type each step then hit ENTER. When you do the "ls", look for the name of your iPod:
  5. Move the file from the Desktop to the directory in which you installed the script.
Linux (assumes iPod is mounted to /mnt/ipod):
  1. Connect your iPod to your computer.
  2. Copy /mnt/ipod/iPod_Control/iTunes/iTunesDB to the directory in which you installed the script. is based on from GNUpod by Adrian Ulrich.

Updated versions of tunes2html will be available at

This program and its components are distributed in the hope that it will be useful, but WITHOUT ANY WARRANTY; without even the implied warranty of MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the GNU General Public License for more details.

If you have any questions, comments, suggestions, or praise, please e-mail me at jmmallon at joescafe dot com.

Joe Mallon