Skip site navigation (1)Skip section navigation (2)

FreeBSD Manual Pages

  
 
  

home | help
dvd-menu(1)			 dvd-slideshow			   dvd-menu(1)

NAME
       dvd-menu	- Creates a DVD	navigation menu	with buttons.

SYNOPSIS
       dvd-menu	  -t  <ButtonText1>  ...  -t  <ButtonTextN>  -f	 <XML_file1  |
       MPEG_file1> ... -f <XML_fileN | MPEG_fileN> [-o <output directory>] [-n
       <DVD Title>] [-b	<background jpeg>] [-e <embed image>] [-a <audiofile>]
       [-p] [-c] [-D] [-W] [-mp2] [-iso] [-nomenu] [-L]

DESCRIPTION
       Creates a simple	top-level DVD menu with	buttons	that link  to  movies.
       Accepts	the  output  XML files from dvd-slideshow or your own self-de-
       fined MPEG movies.

OPTIONS
       -t <Button text>
	      The button text visible on the menu which	will link to each cor-
	      responding  (in order passed) -f option.	Use this option	multi-
	      ple times	with -f	to define multiple titles/buttons.

       -f <Input file>
	      Can be an	XML file output	 from  dvd-slidshow  or	 a  full-scale
	      mpeg2  video  in the proper format (.vob).  No error checking is
	      done if you pass a MPEG2 .vob input file,	so  you	 are  on  your
	      own.  Use	 this option multiple times with -t to define multiple
	      titles/buttons.

       [-o <Output directory>]
	      Directory	where the final	DVD filesystem files VIDEO_TS/ will be
	      written.

       [-n <DVD	Title>]
	      This will	be printed at the top of the DVD menu page.

       [-b <Background jpeg>]
	      Image  to	 use for the background	DVD menu. If no	file is	speci-
	      fied, a blue gradient will be used for the menu background.

       [-e <embed image>]
	      Embed an image in	the menu screen.  This image will show	up  to
	      the left of the menu buttons.

       [-a <Audio file>]
	      Audio  file to play while	the menu is active. Supports mp3, ogg,
	      or wav formats at	this point.

       [-mp2] Use mp2 audio by default (requires ffmpeg	 with  ac3  encoding).
	      The default audio	format is now AC3 instead of mpeg2 sinceI have
	      found that many DVD players do not play the audio	when it	is  in
	      mp2  format, so this may be a better, more compatible option for
	      most people.

       [-p]   Use PAL output video format instead of NTSC.

       [-c]   Use continuous <post> commands within dvdauthor.	This will make
	      each  video  play	one after another without going	back up	to the
	      main menu	until the last video is	finished.  If this  option  is
	      not used,	the dvd	will return to the top menu after playing each
	      track.

       [-D]   Do not call dvdauthor.  This will	tell dvd-menu  to  create  the
	      menu and output xml files	to pass	to dvdauthor, but will not ac-
	      tually run dvdauthor.  Useful for	 people	 who  want  to	modify
	      their xml	file before running dvdauthor.

       [-W]   Do  not generate 50% transparent white background	overlays under
	      the title	and menu buttons.

       [-iso] Create iso image with mkisofs when finished.

       [-nomenu]
	      Do not create a menu.  Useful for	just finishing	the  dvdauthor
	      xml file from one	video that you want to just start playing when
	      the user puts it into a dvd player.

       [-L]   Create  a	 low  quality,	half-slize  menu.   This  works	  with
	      dvd-slideshow  so	you can	render your whole project in low-qual-
	      ity mode and still test everything quickly.

       [-theme <themefile>]
	      Use the given theme when	setting	 variables/colors/etc.	Themes
	      are  installed in	/opt/dvd-slideshow/themes or in	a local	direc-
	      tory ~/.dvd-slideshow/themes

       [-fadein]
	      Fade in from background before menu

       [-fadeout]
	      Fade to background after menu buttons are	pressed.

       [-vcd] (alpha) Create vcd .cue and .bin files (requires vcdimager)

       [-svcd]
	      (alpha) Create svcd .cue and .bin	files (requires	vcdimager)

       -h     Prints help file (basically this manpage).

CONFIGURATION
       Settings	 can  be  passed  on  the   command   line,   in   a   default
       ~/.dvd-slideshow/dvd-slideshowrc	 file,	or in a	theme file.  The order
       in which	the script reads the settings is as follows:
       Default script settings --> ~/.dvd-slideshow/dvd-slideshowrc -->	 theme
       --> command line
       so each successive setting will over-ride the previous settings if they
       are already set.

       ~/.dvd-slideshow/dvd-slideshowrc:
	      With the syntax shown below,  the	 following  variables  can  be
	      specified	 in  the  ~/.dvd-slideshow/dvd-slideshowrc  file.  All
	      lines are	optional, and everything after the # character is  not
	      read.

	      #	general:
	      menu_continuous_play=0 # set to 1	to play	one file after another
	      without going back up to menu.

	      menu_fadein=0 # set to 1 to fade in to menu
	      menu_fadeout=0 # set to 1	to fade	out from menu after  a	button
	      is pressed.

	      menu_background=steelblue	 # or, use hex #RRGGBB
	      #menu_background="#882211"       #  use  a  hex RGB color	if you
	      wish
	      #menu_background="mybackground.jpg"     #	specify	a  real	 image
	      if you want
	      ##     pick     other	colors	   here:     http://www.image-
	      magick.org/script/color.php

	      menu_fade_to_image="black"      #	 image	to  fade  to/from  be-
	      fore/after menu
	      #menu_fade_to_image="#ff3344"
	      #menu_fade_to_image="myimage.jpg"

	      #menu_title_font="/usr/share/fonts/default/Type1/n019004l.pfb" #
	      Helvetical bold URW font
	      menu_title_font_size=40
	      menu_title_font_color=black
	      menu_title_white_height=125
	      menu_title_location_x=80
	      menu_title_location_y=50
	      #menu_title_justify=center

	      menu_panel_height=28
	      menu_panel_width=288
	      menu_panel_location_x=360
	      menu_panel_location_y=175	 # distance of the top	of  the	 first
	      menu item	to the top of the screen

	      #menu_button_font="/usr/share/fonts/default/Type1/n019004l.pfb"
	      #	Helvetical bold	URW font
	      menu_button_font_size=21
	      menu_button_font_color=black
	      menu_button_hilight_color=red

	      #menu_audio=myaudio1.mp3

THEMES
       A theme is just a file containing a list	 of  configuration  variables,
       and possibly also background images, fonts, or audio in the same	direc-
       tory.

       Any of the configuration	variables can be  placed  in  a	 dvd-slideshow
       theme file to control dvd-menu also.

       This will be explained more later...

FILES
       dvd-slideshow
       dvd-menu
       gallery1-to-slideshow
       dir2slideshow
       jigl2slideshow

EXAMPLES
       There  are  a  few heavily-commented examples available in the examples
       section	of  the	 dvd-slideshow	webpage,  which	 you   can   find   at
       http://dvd-slideshow.sourceforge.net

AUTHORS
       Scott Dylewski <scott at	dylewski dot com>
       http://dvd-slideshow.sourceforge.net

SEE ALSO
       dvd-slideshow(1)

Scott Dylewski			     0.8.4			   dvd-menu(1)

NAME | SYNOPSIS | DESCRIPTION | OPTIONS | CONFIGURATION | THEMES | FILES | EXAMPLES | AUTHORS | SEE ALSO

Want to link to this manual page? Use this URL:
<https://www.freebsd.org/cgi/man.cgi?query=dvd-menu&sektion=1&manpath=FreeBSD+12.0-RELEASE+and+Ports>

home | help