getdvdchap v1.0 Readme
by Adam Jarret
adam@adamjarret.com
http://www.adamjarret.com

=============================
Abstract
=============================

getdvdchap is a Perl script that I wrote to extract the chapter start times from DVD IFO files.

The script uses dvdxchap (http://www.bunkus.org/videotools/ogmtools/dvdxchap.1.html) to extract the chapter data and then parses the output to form a comma separated list for easy use with dvdauthor (http://dvdauthor.sourceforge.net/).

This script could be useful if you rip a DVD in a way that loses chapter data, but wish to re-author it using dvdauthor and do not want to have to manually enter the start times for each chapter.
                

=============================
Requirements
=============================

dvdxchap must be installed for this script to work (see Installation).

I include an OS X PPC binary of dvdxchap with getdvdchap because there is no longer an offical port availible.

dvdxchap is provided as part of the OGMtools which can be found at http://www.bunkus.org/videotools/ogmtools/ - It was ported for use with OS X by Shawn Holwegner and until recently was availible on his site (http://www.holwegner.com/software/). The source code for dvdxchap is still availible with the OGMtools source.


=============================
Installation
=============================

Copy both the getdvdchap Perl script and the dvdxchap binary into a bin folder (either /usr/local/bin or /bin should work fine) and make sure to set the 'execute' permissions using chmod.


=============================
Usage
=============================

Type

	getdvdchap /Volumes/DVD

into the Terminal, replacing "/Volumes/DVD" with the path to the IFO files you wish to read (usually in the VIDEO_TS folder of a DVD).

Alternately, you can just type 

	getdvdchap

and the script will look for a DVD mounted at disk1.