ID3v2 Chapter Tool

File Release Notes and Changelog

Release Name: chaptool-1.4.4

Notes:
BBC ID3v2 Chapter Tool Version 1.4
==================================

Capabilities
------------
The application will currently accept input files using 
ID3 version 2.2 and 2.3 tags (or no tag). The output files
contain an ID3v2 version 2.3 tag.

Requirements
------------
The application has been developed using Java 1.4 and 
JMF2.1.1e but should work with later versions. Both of 
these are available from java.sun.com. If you have 
problems you can check your JMF installation by running 
the Applet at:

http://java.sun.com/products/java-media/jmf/2.1.1/jmfdiagnostics.html

The JAR file jmf.jar must be included in your CLASSPATH 
environmental variable.

Running ID3v2ChapterTool
------------------------
After unzipping the archive Windows users can launch the 
application by running ID3v2ChapterTool.bat whilst Linux 
users can run ID3v2ChapterTool.sh. An icon is provided
that can be associated with these files.

A batch file called XMLTool is included to allow command 
line operation. Type "XMLTool" for details of the required 
parameters. An XML file is required to define the chapters 
using the same format used by Apple's chapter tool. These 
XML files can be exported from the ID3v2ChapterTool 
application.

Warning
-------
ID3v2 Chapter signalling is not currently supported by most
media players. 

Although the signalling is unlikely to cause problems it 
may be some time before you will be able to see a benefit.
However, if you are developing a media player which 
supports chapters you should find this application useful.

Bugs
----
JMF has problems with ID3v2 tags that exceed 100 KB. If you 
exceed this limit (e.g. by adding lots of images) this will 
stop you saving or playing the file.

Contact and Legal Information
-----------------------------
Copyright 2006 British Broadcasting Corporation

The BBC R&D ID3v2ChapterTool application is free software; 
you can redistribute it and/or modify it under the terms of
the GNU Lesser General Public License as published by the
Free Software Foundation; either version 2 of the License,
or (at your option) any later version.

The BBC R&D ID3v2ChapterTool application 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 Lesser 
General Public License for more details.

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

For further information visit:
<http://sourceforge.net/projects/id3v2-chap-tool/>

Changes:
BBC ID3v2 Chapter Tool Development History
==========================================

Version 1.4.4
-------------
Publication date: 18 April 2006

1. Added new ChapterPlayer application.

Version 1.4.3
-------------
Publication date: 16 March 2006

1. Added converter for reserved XML characters to the "Export"
   function. These would otherwise result in an invalid XML
   document and cause problems with the "Import" function.

Version 1.4.2
-------------
Publication date: 23 February 2006

1. Introduced workaround to JMF problem which results in
   inaccurate chapter start and end times. JMF appears to
   assume that ID3 tag data is audio data and includes it
   when setting or getting the media time.

Version 1.4.1
-------------
Publication date: 9 February 2006

1. Revised version of the de.vdheide.mp3 library

2. Details of chapter related images and URLs carried in
   subframes are now visible.

Version 1.3
-----------
Publication date: 31 January 2006

1. Added Import and Export functions to/from the Apple XML
   chapter file format.

2. Fixed tag length bug in de.vdheide.mp3.ID3v2 class. This
   caused playback problems with some media players.

3. Output files do not now use extended headers or padding
   and are not unsynchronized due problems found in
   de.vdheide.mp3.ID3v2

4. ID3v2.2 input files can now be used and are converted to
   ID3v2.3.

Version 1.2
-----------
Publication date: 16 November 2005

1. Corrected bug in the CHAPFrame class which affected time
   and byte offset values.

Version 1.1
-----------
Publication date: 8 November 2005

1. Revised to conform with Revision 3 of the draft Chapter 
   Frame proposal.

Version 1.0
-----------
Publication date: 23 September 2005

Initial release.