NAME
makexml - Generate a video disc structure XML description
DESCRIPTION
makexml generates XML output describing an (S)VCD or DVD file structure
and navigation hierarchy in the format expected by dvdauthor
(http://dvdauthor.sourceforge.net/) or vcdxbuild
(http://www.vcdimager.org/).
USAGE
makexml [OPTIONS] VIDEOS -out OUTFILE
For example:
$ makexml -menu MainMenu.mpg \
Season1.mpg Season2.mpg Featurettes.mpg \
-out MyDisc
OPTIONS
-dvd (default)
Generate the XML for a DVD disc, to be used with dvdauthor or
makedvd.
-vcd Generate the XML for a VCD disc, to be used with vcdxbuild or
makevcd.
-svcd Generate the XML for an SVCD disc, to be used with vcdxbuild or
makevcd.
-overwrite
Overwrite any existing output files.
-quiet Limit output to essential messages.
VIDEOS may be any of the following:
<file list>
List of one or more video files to include, separated by spaces.
At minimum, a DVD must have one video file. You can use shell
wildcards (i.e., "*.mpg") to include multiple files easily. Put
filenames in quotes if they have spaces in them.
-menu VIDEO <file list>
Use video file VIDEO as a menu from which you can jump to each
of the listed video files. If you have multiple menus, include a
top menu so they are reachable.
-slides <file list>
Create a slide-show of still images
DVD-only options
-group <file list> -endgroup
(DVD only) List of video files to include as one single title.
This is useful if you have split a movie into several video
files.
-topmenu VIDEO [-menu VIDEO <file list>] [-menu VIDEO <file list>]...
(DVD only) Use video file VIDEO for the top-level (VMGM) menu.
The top menu will jump to each of the subsequent [-menu...]
videos listed. Use this only if you have multiple sub-menus to
jump to. You can only have one top menu.
-titlesets
(DVD only) Forces the creation of a separate titleset per title.
This is useful if the titles of a DVD have different video
formats, e.g. PAL + NTSC or 4:3 + 16:9. If used with menus,
there must be a -topmenu option that specifies a menu file with
an entry for each of the titlesets.
-chapters INTERVAL
(DVD only) Creates a chapter every INTERVAL minutes (default 5
minutes: without -chapters, each movie will be divided into
5-minute chapters). This option can be put at any position in a
<file list> and is valid for all subsequent titles until a new
-chapters option is encountered. Using this option may take
some time, since the duration of the video is calculated.
-nochapters
(DVD only) Don't create chapters for the videos.
OUT_PREFIX is the file that will receive the resulting XML.
USAGE NOTES
makexml checks to make sure the video filenames you give it exist, but
it does not check whether they are valid for the chosen disc format.
MPEG videos of menus should have the specified number of buttons for
reaching each of the videos, and, if you're using DVD, should be
multiplexed with their corresponding subtitles using spumux of the
dvdauthor 0.6.0 package prior to authoring using dvdauthor. If you use
the makemenu (makemenu.html) component to generate the menu, this
should all be handled for you.
EXAMPLES
makexml -dvd title-1.mpg title-2.mpg title-3.mpg -out My_DVD
Make a DVD without a menu. Title 1, 2, and 3 will play in
sequence.
makexml -dvd -group chapter-1.mpg chapter-2.mpg chapter-3.mpg -endgroup
-out My_DVD
Group the file chapter-1|2|3.mpg into one title and make a DVD
without a menu.
makexml -dvd -menu main_menu.mpg -chapters 3 movie-1.mpg -chapters 10
movie-2.mpg -out My_DVD
Make a DVD with a main menu that points to two movies, with
movie-1.mpg divided into 3-minute chapters, and movie-2.mpg into
10-minute chapters.
SEE ALSO
idvid(1), makedvd(1), makemenu(1), makeslides(1), makevcd(1),
makexml(1), postproc(1), tovid(1), todisc(1)
CONTACT
For further assistance, contact information, forum and IRC links,
please refer to the tovid homepage (http://tovid.org/).
MAKEXML MANUAL(1)