DVDA-AUTHOR

NAME

SYNOPSIS

DESCRIPTION

from .wav, .flac and other audio files.  

OPTIONS

-h, --help Diplay this help.

-v, --version Diplay version.

-q, --quiet Quiet mode.

-d, --debug Increased verbosity (debugging level)

-t, --veryverbose Like -d with enhanced verbosity for sample counts.

-P, --pause Insert a final pause before exiting.

-P0, --pause0 Suppress a final pause before exiting

if specified in configuration file.

-l, --log filepath Ouput a log to filepath.

-#, --logrefresh filepath Same as -l but prior log will be erased on launching again.

-a, --autoplay Launches playback on loading disc.

-m, --topmenu(=mpgfile) Generates top menu from mpgfile.

Without argument, automatic menu generation is launched.

-u, --duration hh:mm:ss Duration of top menu file, if provided.

It is mandatory when --topmenu has an argument file.

-~, --nmenus int Generates int top menus (default 1).

-{, --ncolumns int Top menus will have at most int columns (default 3).

-+, --menustyle desc Specifies top menu style

By default, tracks are listed under group headers.

If desc='hierarchical', the first menu screen lists groups.

If desc='active', all tracks will have an associated still picture with menu links that remain active while listening to the track.

-M, --xml filepath Generates dvdauthor xml project

to filepath.

-H, --spuxml filepath Generates spumux xml project

to filepath.

-G, --image file Menu Background image for customized menu authoring.

-E, --highlight file Menu Highlight image for customized menu authoring.

-e, --select file Menu Select image

image that appears on pressing Enter with remote control usually Background with a change in text color.

-N, --blankscreen file For automatic menu authoring, you can replace black video background with this image.

-O, --screentext string Text for top menu. Format is

"album_text=group1_text=text(title11),text(title21),...,text(titlen1):group2_text=text(title12),text(title22)...,text(titlen2):..."

with text(titlenk) the text for title n of group k and

groupk_text the text for group k.

-U, --loop loop background video.

-K, --highlightformat -1 for automatic menu authoring

with little square before titles, 0 for underlining, 1 for button highlight.

-J, --font a,b,c Font name,font size,font width

(number of pixels for width of font size 10).

Font name should be compatible with Image magick specifications (mogrify -list font).

-Y, --palette string Text for system palette. Format is

"textcolor,backgroundcolor,highlightcolor,select action color" in alpha-YCrCb 32-bit hexa coding.

-y, --colors string Text for menu colors. Format is

either "norefresh", to block the refreshing of menu images, or textcolor:backgroundcolor:highlightcolor:select action color in rgb values a,b,c between 0 and 255.

-b, --background Background jpg files (comma-separated) to create a background mpg file

into which titles are multiplexed.

-!, --stillpics Background jpg files to create one or more still pictures

for each track.See usage below.

If a track has no still picture, use two hyphens in a row.

You may otherwise indicate a directory containing pictures

named pic_abc.jpg, with a,b,c between 0 and 9.

-!, --stillpics dir/ Directory for background jpg files to create one still picture for each track.

Pics should be named pic_000.jpg, ..., up to pic_999.jpg (maximum).

-?, --stilloptions ... Still picture options (add after --stillpics). Each option applies to ranked pic, e.g.

rank=0,manual,starteffect=fade,rank=1,starteffect=dissolve.

Suboptions are:

rank=[number], starteffect=[effect], endeffect=[effect]

manual, lag=[number], start=[number], active

See details below.

-B, --background-mpg f Background mpg file f

into which titles are multiplexed.

-??, --norm Argument is 'ntsc', 'pal' or 'secam', depending on TV standard.

-@, --aspect Set the playback aspect ratio code of the encoded video.

By default, this value is inferred from

the input header.

1

- 1:1 display

2

- 4:3 display

3

- 16:9 display

4

- 2.21:1 display

-Q, --soundtrack file Background wav file f

to be multiplexed into background menu

By default a silent track will be multiplexed.

-A, --topvob f Import already authored top vob menu f.

-=, --stillvob f Import already authored still pictures vob.

-I, --mkisofs(=file) Run mkisofs to author disc image using file

as an ISO image. If file is empty, use tempdir/dvd.iso.

-r, --cdrecord(=a,b,c) Run cdrecord to burn disc image.

Unless specified, --mkisofs will be automatically triggered with default tempdir/dvd.iso value.

Device is of the form a,b,c, see cdrecord -scanbus. It can be omitted

if there is just one writer.

-R, --growisofs /dev/dvd Run growisofs to burn disc image.

Device is of the form /dev/scd0 under many GNU/Linux distributions.

It cannot be omitted.

-k, --text Generates text table in IFO files

Under development, implemented for 1-group discs.

Use file information as arguments separated by commas.

-p, --startsector NNN Specify the number of the first sector

of the AUDIO_PP.IFO file in the output of mkisofs.

If NNN=0, falling back on 281 (default).

Without -p start sector will be computed automatically.

-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].

-j, Like -g with special processing to avoid gaps.

Minimum: one group.

-s, Like -g with all tracks merged into one single track.

Minimum: one group.

-z, --newtitle Separate two consecutive titles when files have same audio

characteritics within a group.

-i, --input directory Input directory with audio files.

Each subdirectory is a group.

-o, --output directory Output directory.

-x, --extract disc[list] Extract DVD-Audio to directory -o.

Groups are labelled g1, g2...

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.IFO).

In this case the path to the VIDEO_TS linked to

must be indicated.

-D, --tempdir directory Temporary directory.

-X, --workdir directory Working directory: current directory in command line relative paths.

With Code::Blocks and similar IDE, specify your root package directory as argument to --workdir.

-Z, --playlist You may specify up to 9 group copies.

Total number of groups and copy groups should not exceed 9.

-n, --no-videozone Do not generate an empty VIDEO_TS directory.

-w, --rights Access rights to directories created (octal values)

-U, --PTS-factor (-)lag Enter lag to be added/substracted (-) to title length,

in 10E-2 second.

-c, --cga Enter channel group assignment right after group (-g, -j or -s).

-F, --fixwav(options) Bad wav headers will be fixed by fixwav

-f, --fixwav-virtual(options) Use .wav header repair utility

without any write operation.

-S, --sox Use SoX to convert files to .wav.

By default, only flac, Ogg FLAC

and .wav files are accepted.

-0, --no-padding Block padding of audio files by dvda-author.

-1, --minimal-padding Only pad for evenness of sample count.

-C, --pad-cont When padding, pad with last known byte, not 0.

-L, --lossy-rounding Sample count rounding will be performed by cutting audio files.

-W, --disable-lexer Deactivates configuration file parsing.

fixwav sub-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

Launches fixwav before SoX for mangled headers

output=sf

Copy corrected file to new filepath with string suffix sf

infodir=db

Copy info chunks from wav headers to file db/database

Sub-options should be separated by commas and appended

after short option or after = sign if long option is used:

-f/-Fsuboption or --fixwav(-virtual)=suboption

without any whitespace in between them.

Example: --fixwav=simple-mode,prepend,interactive,output=new

Still picture arguments:

p11,p21,...,pn1-p22,p22,...,pn2-...

with tracks separated by hyphens and pictures by commas.

Examples: -g ~/a.wav --stillpics image1.jpg,image2.jpg,image3.jpg-image4.jpg,image5.jpg,image6.jpg

If there are no pics for a track use -- as below (no pics for second track):

-g ~/a.wav ~/b.wav ~/c.wav --stillpics image1.jpg,image2.jpg,image3.jpg--image4.jpg,image5.jpg,image6.jpg

Still picture sub-options:

rank=k

k is the absolute rank of stillpic (0-based) to which the following options apply (order-dependent).

start=k

picture starts at k sec from start of track.

manual

Enable browsable (manual advance) pictures (experimental).

starteffect=effect

transition effect at start of pic: cut (default), fade, dissolve, top-wipe, bottom-wipe, left-wipe, right-wipe.

endeffect=effect

like starteffect at end of pic show (under development)

lag=k

k is the duration of transition effect in multiples of 0.32 second (k < 16).

active

menu links will be displayed on still picture and remain active while listening.

Example: --stilloptions rank=0,start=03,starteffect=fade,lag=12,rank=1,start=20,starteffect=dissolve,lag=15

Transition effects like fade or dissolve may vary depending on hardware.

End effects may be visible only when several pictures are used for a track slide.

If a track has just one still pic, only start effects may be visible.

Note: for optional arguments noted (=...) above, usage is either

-xY, with x the option flag and Y the argument, or

--option=argument.

Supported audio types: .wav

.flac and .oga (Ogg FLAC, see below)

SoX-supported formats with -S enabled

except for lossy formats.

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  

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,3,5,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.

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.

_LARGEFILE_SOURCE,_LARGE_FILES,_FILE_OFFSET_BITS=64

to enable large file support.

ALWAYS_INLINE forces code inlining.

WITHOUT_SOX to compile without SoX code

WITHOUT_FLAC to compile without FLAC/OggFLAC code

WITHOUT_FIXWAV to compile without fixwav code  

AUTHOR

REPORTING BUGS

COPYRIGHT

Latest version available from http://dvd-audio.sourceforge.net/

This is free software; see the source for copying conditions.

Index

NAME

SYNOPSIS

DESCRIPTION

OPTIONS

EXAMPLES

AUTHOR

REPORTING BUGS

COPYRIGHT