DragonFly On-Line Manual Pages
DVDA-AUTHOR(1) User Commands DVDA-AUTHOR(1)
NAME
dvda-author - manual page for dvda-author
SYNOPSIS
dvda-author [OPTION]...
DESCRIPTION
dvda-author 09.05 creates high-resolution DVD-Audio discs from .wav,
.flac, .oga and SoX-supported audio formats.
OPTIONS
-h, --help Diplay this help.
-v, --version Diplay version.
-q, --quiet Quiet mode.
-W, --disable-lexer Disables configuration file parsing.
-P, --pause Insert a final pause before exiting.
-P0, --pause0 Suppresses any final pause before exiting.
-l, --log filepath Ouput a log to filepath.
-p, --startsector NNN Specify the number of the first start sector
of the AUDIO_PP.I FO file in the output of mkisofs If NNN=0,
start sector takes default value 281.
By default, start sector is automatically computed.
-g You may specify up to 9 groups of tracks.
Minimum: one group. Enter full path to files if input directory
is not set by [-i].
-i, --input directory Input directory with audio files.
Each subdirectory is a group.
-o, --output directory Output directory.
-S, --sox Convert audio files with SoX.
-x, --extract disc[list] Extract DVD-Audio to directory -o.
Groups are labelled g1, g2... An optional comma-separated list
of groups to be extracted may be appended to disc path.
-V, --videodir directory Path to VIDEO_TS directory
-T, --videolink rank Rank of video titleset linked to in video zone
(XX in VTS_XX_0.I FO). In this case the path to the VIDEO_TS
linked to must be indicated.
-n, --no-videozone Do not generate an empty VIDEO_TS directory.
-w, --rights Access rights to directories created (octal
values)
-d, --debug Increased verbosity (debugging level)
-U, --PTS-factor (-)lag Enter lag to be added/substracted (-) to title
length,
in 10E-2 second.
-F, --fixwav(options) Bad wav headers will be fixed by fixwav
-f, --fixwav-virtual(options) Use .wav header repair utility without
any write operation.
-0, --no-padding Block padding of audio files by dvda-author.
-L, --lossy-rounding Sample count rounding will be performed by
cutting audio files.
-C, --pad-cont When padding, pad with last known byte, not
0s.
Supported audio types: .wav, .flac, .oga (if built with Ogg FLAC
support), SoX-supported formats (if built with SoX support).
There must be a maximum of 9 audio groups.
Each subdirectory of an audio input directory will contain titles for a
separate audio group.
A number between 1 and 9 must be included as the second character of
the subdirectory relative name.
Full Input/Output paths must be specified unless default settings are
set.
By default, defaults are set in /full path to dvda-author
folder/defaults
Fixwav options
simple-mode
Deactivate default automatic mode and advanced options. User
will be asked for more information.
prepend
Prepend header to raw file
in-place
Correct header in the original file (not advised)
cautious
Be cautious when overwriting files in-place
interactive
Request information from user.
padding
Pad files according to WAV standard.
prune
Cuts off silence at end of files
force
forces WAV header on a mangled RIFF-less or fmt-less header
(launching fixwav before SoX)
output=sf
Copy corrected file to new filepath with string suffix sf
infodir=db
Copy info chunks from WAV headers to file named database in
directory db.
Sub-options should be separated by commas and appended to -f/-F or
--fixwav(-virtual)= without any whitespace in between them.
Example: --fixwav=simple-mode,prepend,interactive,output=new
fixwav should be used whenever non-standard WAV headers are to be
processed.
In particular with SoX-supported input, WAV headers resulting from SoX
conversion
will be non-standard. Audio data may be impaired if option -f
(--fixwav-virtual)
or -F (--fixwav) is not used.
fixwav suboption prune is to be used when audio files have been roughly
cut by
editors, which may cause useless padding and playback gaps.
It can be combined with main option -L (or --lossy-rounding) to ensure
maximal
reduction of possible audio gaps with only minor audio loss. -L should
not be used
if tracks have been cut in 'continuous' audio streams.
fixwav suboption 'padding' is compatible with suboption prune.
It performs padding to ensure even whole sample counts, whilst
dvda-author padding is designed to ensure that sample units are
compliant with interleaving
constraints (which may add up more padding).
fixwav=prune,padding thereby adds the minimal amount of 0s at end of
file.
Suboption force is to be used as a last resort, when audio headers have
been
mangled to the point of losing all necessary information on audio
parameters.
It will trigger fixwav before lauching SoX, which could crash
otherwise.
Use suboption prepend with raw audio files (headerless).
EXAMPLES
-creates a 3-group DVD-Audio disc (legacy syntax):
dvda-author -g file1.wav file2.flac -g file3.flac -g file4.wav
-creates a hybrid DVD disc with both AUDIO_TS mirroring
audio_input_directory
and VIDEO_TS imported from directory VID, outputs disc structure
to directory
DVD_HYBRID and links video titleset #2 of VIDEO_TS to AUDIO_TS:
dvda-author -i ~/audio/audio_input_directory -o DVD_HYBRID -V
~/Video/VID -T 2
-creates an audio folder from an existing DVD-Audio disc:
dvda-author --extract /media/cdrom0,1:11,3:21,5:11111,6,7 -o dir
will extract titlesets 1,3,5,6,7 of the disc to dir/g1, dir/g3,
dir/g5, dir/g6, dir/g7 respectively.
Group 1 tracks will be split into 2 mono channels, group 2 ones
into stereo + mono channels, group 5 into 5 mono channels per
track.a
Required compile-time constants:
_GNU_SOURCE, __CB__ if compiling with Code::Blocks or similar
IDE.
Optional compile-time constants:
LONG_OPTIONS for the above long options (starting with --)
SHORT_OPTIONS_ONLY to block all long options.
LOCALE to recompile for another locale than the default "C".
SETTINGSFILE to specify default filepath of the configuration
file.
FLAC__HAS_OGG to enable Ogg FLAC support.
AUTHOR
Written by Dave Chapman (2005), Fabrice Nicol (2007-2009) and Lee and
Tim Feldkamp (2008).
REPORTING BUGS
Report bugs to fabnicol@users.sourceforge.net
dvda-author version 09.05
Copyright 2005 Dave Chapman; 2007-2009 Fabrice Nicol; 2008 Lee and Tim
Feldkamp.
Latest version available from http://dvd-audio.sourceforge.net/
This is free software; see the source for copying conditions.
dvda-author May 2009 DVDA-AUTHOR(1)