DVDWIZARD(1)

NAME
DVDwizard — automated creation of DVD structure

SYNOPSIS
dvdwizard [options] mpeg-file [mpeg-file2 ...]

DESCRIPTION
DVDwizard is a wrapper-script which incorporates a fully automated creation of a DVD-structure with chapters and menus from one or more mpeg-streams. This is done by several "sub-scripts" and various freely available tools.

OPTIONS

  General processing

-C | --config-file filename
    filename of dvdwizard-configuration file [~/.config/dvdwizard/dvdwizard.conf]

-o | --output directory
    Path where the final DVD will be stored [BASEDIR/dvd]

-x | --xml filename
    Print dvdauthor XML-specs into this file [BASEDIR/dvdwizard.xml]

-l | --logfile filename
    Write Log-Messages to this file [BASEDIR/dvdwizard.log]

-y | --yes
    Allow all target directories to be overwritten

-D | --debug
    Logging with console debug infos

-h | --help
    print this lot out

-v | --version
    print version and exit

--restart step
    Do not start from beginning but from step. Step may be dvdcpics, mk_vmgm, mk_vtsm, author.

--xmlonly
    Do not author final DVD, only create menus and xml and remove temp. DVD structure.

--xmlkeep
    Like --xmlonly, but keep temporary DVD structure.

  DVD-specific options

-T  | --vmgm string
    Titlestring for the whole DVD; if not specified no title will be printed on the main menu.

-N  | --tvnorm <norm>
    TV-Norm to use. Norm may be PAL or NTSC. [PAL]

-V  | --tvsize WidexHeight
    Visible Area on TV-Screen. [660x530]

-M  | --menu language
    Define language to use in menu items [en]. Strings are defined in config file.

-WS <option>
    Widescreen-Option for whole DVD may be nopanscan or noletterbox. Can be overwritten by -ws for a specific titleset.

-P  | --palette filename
    Name of palette file, needed i.e. for subpictures.

-A  | --Audio lang[,lang2,...]
    Language for audiotracks [en]. Languages are applied to audiotracks in order they appear in the mpeg stream. Applies to all titlesets on the DVD, can be overwritten by -a for a specific titleset.

-I  | --intro filename
    MPEG-File to be played when inserting the DVD in the player.

-L  | --loop value
    Playback mode of the DVD. Possible values are:
    0   return to vmgm menu after each title,
    -1  display vmgm menu before the first and after the last title,
    -2  display vmgm menu only before first title and loop all titles endlessly,
    num num is a value between 1 and 9. Suppress vmgm menu and loop all titles endlessly, starting from specified title.

-MS | --vmgmsound filename
    Soundfile to be used as background sound for all menus (may be overwritten for specific titlesets with -ms|--vtsmsound). If empty, a silent audio track will be produced. Can be any format, ffmpeg recognizes and will be converted to ac3, if necessary.

-W  | --pause number
    Wait a number of seconds as pause at the end of each titleset.

  Title-specific options

-t  | --vts string
    Create a new titleset on the DVD with the subsequent options and mpeg-files. -t must be followed by a filename or a string or the word "auto". "auto" determines title-string from filename of first mpeg-file, if -t is followed by an existing filename, that file is considered to be the first mpeg in this titleset, else the string is used as movie title for this titleset.

-c  | --chapters <spec>
    Chapter-Specification may be 0|file|timecodes|interval. [300] 0 means no chaptering except for different mpeg-files.

-b  | --vtsmbg filename
    Filename of background picture for all menus concerning this titleset.

-ar | --aspect <aspectratio>
    Aspect-Ratio-Option aspectratio for correcting detected value of video stream. May be 4:3 or 16:9.

-ws <option>
    Widescreen-Option may be nopanscan or noletterbox for this titleset.

-a  | --audio lang[,lang2,...]
    Language for audiotrack of this titleset. [en]

-s  | --subpic lang1[,lang2,...]
    Pass subpicture information to dvdauthor.This is a string like "en" for english, "de" for german etc. More Languages by Comma Separation, i.e. "-s de,en". Each language may be followed by an optional "+hi" to indicate a subpicture track for hearing impaired, i.e. "-s de,de+hi".

-i  | --info filename
    Points to a text file containing description and the like for the movie.

-ms | --vtsmsound  filename
    see -MS, but only applies to this titleset.

EXAMPLES
Every new -t creates a new titleset on the DVD. Subsequent options -c, -b, -a, -ar and mpeg-file(s) apply only to that titleset. To create a DVD with two titlesets and a special background, use for example:

    dvdwizard -t auto -c 30 title1.mpg \
              -t auto -b bckgrnd.ppm title2.mpg

NOTES
BASEDIR defaults to the current directory if not stated otherwise in the config file (either default ~/.config/dvdwizard/dvdwizard.conf or specified with the -C option).

For more information, sources and executables of DVDwizard see at the homepage http://sf.net/projects/dvdwizard.

AUTHOR
DVDwizard was written by Wolfgang Wershofen <itconsult at wershofen.de>. Since 2009 DVDwizard will be developed by Joo Martin <joomart2009 at users.sf.net>.

This program is free software: you can redistribute it and/or modify it under the terms of the GNU General Public License as published by the Free Software Foundation, either version 3 of the License, or (at your option) any later version.

This package 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 General Public License for more details.

SEE ALSO
mk_vmgm(1), mk_vtsm(1), dvdwizard.conf(5)