ABOUT

  itunesdb is a Tcl library for reading iTunesDB files.

  If you have an iPod, this library may be of use to you.  An iPod uses an
  iTunesDB file to store all information about its music and playlists.  Most
  importantly, iTunesDB associates song titles with files in the iPod's
  filesystem.

SAMPLE USAGE

  % package require itunesdb
  % itunesdb db /mnt/ipod/iPod_Control/iTunes/iTunesDB
  % db seek track
  % while {[db remaining]} {
       array set track [db read]
       puts "$track(artist) - $track(title)"
    }
  % db destroy

URLS

- http://ioioio.net/devel/itunesdb/ - Source code.
- http://wiki.tcl.tk/12185          - Project information and discussion.

PREREQUISITES

- Tcl 8.4 - http://tcl.tk/
- Snit    - http://www.wjduquette.com/snit/

TODO

- More testing, particularly of the error handling and resynchronization
  mechanism.  Also test with iTunesDB files generated by various programs,
  including iTunes itself.  So far all my testing has been with the iTunesDB
  files generated by gtkpod.

WISHLIST

- Documentation.
- Write support.
- Speedups.
- Seeking to arbitrary track or playlist entries.

PROGRAMS USING ITUNESDB

- tclpod - http://ioioio.net/devel/tclpod/
           http://wiki.tcl.tk/tclpod

CHANGELOG

- 11 August 2004 - version 0.1.0
  + Initial release. 

COPYRIGHT

- Andy Goth <unununium@openverse.com>

LICENSE

  I really don't want to duplicate the GPL yet again, so if you want to see the
  license for itunesdb, access the following Web links:

  HTML format: http://www.gnu.org./licenses/gpl.html
  Plain text : http://www.gnu.org./licenses/gpl.txt

vim: set ft=man tw=80 et:
