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)