README
1dvdauthor
2=========
3
4dvdauthor is a program that will generate a DVD-Video movie from a valid
5MPEG-2 stream that should play when you put it in a DVD player.
6
7To start you need MPEG-2 files that contain the necessary DVD-Video VOB
8packets. These can be generated with FFmpeg, or by by passing `-f 8` to `mplex`.
9
10How to Use
11----------
12
13There are 3 steps to building the DVD directory structure on your HDD.
14
151. Delete a previously authored dvd
16
17 dvddirdel [-o dir]
18
19 To guard against mistakes, this will only delete files and subdirectories
20 that look like part of a DVD-Video structure.
21
222. Create your titlesets
23
24 dvdauthor [-o dir] [audio/video/subpicture options] [chapters]
25
26 To create 1 chapter per mpeg, simply do
27
28 dvdauthor [-o dir] [a/v/s options] chap1.mpg chap2.mpg chap3.mpg...
29
30 To manually specify chapters, use the '--chapters' option
31
32 dvdauthor [-o dir] [a/v/s options] -c chap1a.mpg chap1b.mpg -c chap2a.mpg chap2b.mpg ....
33
34 To add chapters every fifteen minutes, do
35
36 dvdauthor [-o dir] [a/v/s options] -c 0,15:00,30:00,45:00,1:00:00,1:15:00... longvideo.mpg
37
38 Call dvdauthor for each titleset you want to create. Note that
39 due to the DVD-Video standard, all audio, video, and subpicture options
40 must be set once for the entire titleset; i.e. you cannot mix PAL
41 and NTSC video in the same titleset. For that you must generate
42 separate titlesets.
43
44 Run dvdauthor -h to see the audio, video, and subpicture options.
45 Note that dvdauthor can autodetect most parameters except the
46 language.
47
483. Create the table of contents
49
50 dvdauthor -T [-o dir]
51
52Voila! You now have a DVD-Video directory structure that will probably
53work! You can now write this out to your DVD, mini-DVD (CD), or just
54play it from your HDD. To generate the UDF image to burn to DVD, use
55`mkisofs` and pass it the `-dvd-video` option.
56
57
58See also
59--------
60
61### FFmpeg
62
63See http://www.ffmpeg.org/.
64
65Note that packages included with your distro are almost certainly out
66of date. Always use the latest version from the Git repository or the
67latest release.
68
69### mjpegtools
70
71See http://mjpeg.sourceforge.net.
72
73It includes `mplex` for building an MPEG-2 system stream with hooks
74for DVD-Video navigation packets.
75
76### mpucoder's site on DVD specifications
77
78See http://www.mpucoder.com/DVD/.
79
80It contains details on the DVD-Video format
81
82### *Inside DVD-Video* on Wikibooks
83
84See http://en.wikibooks.org/wiki/Inside_DVD-Video.
85
86This is a work-in-progress wikibook designed to contain all publicly
87available information on DVD-Video.
88 an attempt to document everything that is publicly known about the
89 DVD-Video spec in a readable form
90