Ubuntu Manpage: DVDwizard — automated creation of DVD structure

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.