File	Date	Author	Commit
doc	2016-02-17	Lawrence D'Oliveiro	[510622] add video_format(7) man page
src	2020-02-26	Hugh McMaster	[45705e] Use PKG_CHECK_MODULES to detect the libxml2 lib...
.gitignore	2010-06-07	Ville Skyttä	[0aa6d9] Tell git to ignore generated files
AUTHORS	2010-03-26	Lawrence D'Oliveiro	[f35e64] mention myself
COPYING	2012-08-20	Ville Skyttä	[8117e5] Sync COPYING and license headers with http://ww...
ChangeLog	2017-07-04	Lawrence D'Oliveiro	[a0d57b] No longer automatically build with ImageMagick ...
INSTALL	2010-04-26	Lawrence D'Oliveiro	[735e88] highlight configure options for backward compat...
Makefile.am	2021-02-01	Lawrence D'Oliveiro	[f93eb7] fix some build warnings
NEWS	2006-05-30	trckjunky@users.sourceforge.net	[cc97fc] 0.6.11 import
README	2014-10-03	Timothy Gu	[2d94b8] Rename README.md to README
TODO	2010-11-03	Lawrence D'Oliveiro	[671825] priorities
bootstrap	2021-02-01	Lawrence D'Oliveiro	[f93eb7] fix some build warnings
clean	2010-04-30	Lawrence D'Oliveiro	[819a22] add script to restore to a pristine source tree
configure.ac	2021-11-05	Lawrence D'Oliveiro	[fe8fe3] Fix another build warning
dvdauthor.spec.in	2016-02-17	Lawrence D'Oliveiro	[510622] add video_format(7) man page
make-dist	2010-10-23	Lawrence D'Oliveiro	[9f0d56] distribution doesn't want this either

Read Me

dvdauthor
=========

dvdauthor is a program that will generate a DVD-Video movie from a valid
MPEG-2 stream that should play when you put it in a DVD player.

To start you need MPEG-2 files that contain the necessary DVD-Video VOB
packets. These can be generated with FFmpeg, or by by passing `-f 8` to `mplex`.

How to Use
----------

There are 3 steps to building the DVD directory structure on your HDD.

1. Delete a previously authored dvd

        dvddirdel [-o dir]

   To guard against mistakes, this will only delete files and subdirectories
   that look like part of a DVD-Video structure.

2. Create your titlesets

        dvdauthor [-o dir] [audio/video/subpicture options] [chapters]

   To create 1 chapter per mpeg, simply do

        dvdauthor [-o dir] [a/v/s options] chap1.mpg chap2.mpg chap3.mpg...

   To manually specify chapters, use the '--chapters' option

        dvdauthor [-o dir] [a/v/s options] -c chap1a.mpg chap1b.mpg -c chap2a.mpg chap2b.mpg ....

   To add chapters every fifteen minutes, do

        dvdauthor [-o dir] [a/v/s options] -c 0,15:00,30:00,45:00,1:00:00,1:15:00... longvideo.mpg

   Call dvdauthor for each titleset you want to create.  Note that
   due to the DVD-Video standard, all audio, video, and subpicture options
   must be set once for the entire titleset; i.e. you cannot mix PAL
   and NTSC video in the same titleset. For that you must generate
   separate titlesets.

   Run dvdauthor -h to see the audio, video, and subpicture options.
   Note that dvdauthor can autodetect most parameters except the
   language.

3. Create the table of contents

        dvdauthor -T [-o dir]

Voila! You now have a DVD-Video directory structure that will probably
work! You can now write this out to your DVD, mini-DVD (CD), or just
play it from your HDD. To generate the UDF image to burn to DVD, use
`mkisofs` and pass it the `-dvd-video` option.


See also
--------

### FFmpeg

See http://www.ffmpeg.org/.

Note that packages included with your distro are almost certainly out
of date. Always use the latest version from the Git repository or the
latest release.

### mjpegtools

See http://mjpeg.sourceforge.net.

It includes `mplex` for building an MPEG-2 system stream with hooks
for DVD-Video navigation packets.

### mpucoder's site on DVD specifications

See http://www.mpucoder.com/DVD/.

It contains details on the DVD-Video format

### *Inside DVD-Video* on Wikibooks

See http://en.wikibooks.org/wiki/Inside_DVD-Video.

This is a work-in-progress wikibook designed to contain all publicly
available information on DVD-Video.
        an attempt to document everything that is publicly known about the
        DVD-Video spec in a readable form