iTOC

iTOC generates a TOC file for use with the AudioTron based on data extracted from iTunes. iTOC is an AppleScript Studio application with an embedded Perl script which parses the iTunes database file iTunes Music Library.xml and outputs the TOC file. This project is free and open source. You may download either the application itself or the entire project including the source code.

If you use iTunes as for ripper/encoder/librarian and your Mac as a file server for your AudioTron, then this application is for you. If you don't know what a TOC file is, let me try to explain. When the AudioTron starts up from a "cold boot", it scans for music files on the share that you've set up to build its internal database of playable items. This scan can take a long time if you have a lot of music files. The TOC file allows the AudioTron to read the file rather than scanning the share to build its internal database. This makes the process about 10 times faster.

History

DateVersionDescription
14-Feb-20030.2Fixed bug which truncated the first character of the directory path.
12-Feb-20030.1Initial release.

Downloads

Copyright / License

Copyright (C) 2003 Bery Rinaldo

This program is free software; you can redistribute it and/or modify it under the terms of the GNU General Public License as published by the Free Software Foundation; either version 2 of the License, or (at your option) any later version.

This program is 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.

You should have received a copy of the GNU General Public License along with this program; if not, write to the Free Software Foundation, Inc., 59 Temple Place - Suite 330, Boston, MA 02111-1307, USA.

Credits

Thanks to Paul Withey for the pointer to the iTunes Music Library.xml file, and to Steve Kokinos for turning on the light bulb as I was working on another related project (Export Playlist to M3U). Also special thanks to Jay Grizzard who authored the Perl script attoc.pl where I learned a lot about how to sort and format the TOC file output.

System Requirements

Mac OS X 10.2 or higher, iTunes 3.0 or higher, AudioTron 3.0 or higher firmware.

Usage

Double-click on the application icon. On the first run, no directory path has been specified, so you will need to choose one from the dialog displayed.

Navigate the the directory that the AudioTron accesses and then click on the Choose button. After the initial folder selection is made, it is saved in a preferences file, then the main iTOC window is displayed.

Click on the Start button. The program will parse the iTunes database looking for files that are under that folder and generate the atrontc.vtc file in the selected folder. While it is processing, a "barber pole" busy indicator is displayed.

When the processing is complete, the message will change to indicate the number of entries in the TOC file.

To change the folder, choose Preferences... from the iTOC menu. A panel will open on top of the main iTOC window allowing you to choose a different folder.

To quit iTOC, simply close the main window, or choose Quit from the iTOC menu. That's all there is to it. If you have any questions or issues, feel free to e-mail me at:

Notes

As of version 0.1, this only supports music files, not playlists. I'm working on ideas for how best to handle playlists. I also have yet to put in my "recently added" support which is in attoc.pl already. So if you have ideas (and you've read this far ;-), please e-mail me at: with your ideas.


This page was last updated on: Wed Feb 12 09:12:20 PST 2003