Content-type: text/html Man page of DVDA-AUTHOR

DVDA-AUTHOR

Section: User Commands (1)
Updated: May 2009
Index Return to Main Contents
 

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.
If a group contains multichannel files, you can optionally split them into separated mono or stereo tracks,
by adding e.g. :221 for two stereo channels plus one mono channel.

-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

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.


 

Index

NAME
SYNOPSIS
DESCRIPTION
OPTIONS
Fixwav options
EXAMPLES
Required compile-time constants:
Optional compile-time constants:
AUTHOR
REPORTING BUGS

This document was created by man2html, using the manual pages.
Time: 22:52:37 GMT, June 01, 2009