Bino(1) 						      General Commands Manual							   Bino(1)

NAME

       Bino - a 3D video player with multi-display support.

SYNOPSIS

       bino [option...] [file...]

DESCRIPTION

       Bino  plays  stereoscopic  videos, also known as 3D videos. Such videos have separate views for the left and right eye and thus allow depth
       perception through stereopsis.
       All input files are combined into one media source, so you can have video, audio, and subtitle streams in separate  files.  The	files  are
       decoded with the FFmpeg libraries, so URLs and other special constructs are supported.

       --help Print help.

       --version
	      Print version.

       -n|--no-gui
	      Do not use the GUI, just play the given input in a plain window using the parameters given on the command line.

       --log-file=FILE
	      Append all log messages to the given file.

       -L|--log-level=LEVEL
	      Select log level: debug, info, warning, error, or quiet.

       --list-audio-devices
	      Print a list of known audio devices and exit.

       -A|--audio-device=N
	      Use audio device number N. N=0 is the default device.

       -D|--audio-delay=D
	      Delay audio by D milliseconds. Default is 0.

       -V|--audio-volume=V
	      Set audio volume (0 to 1). Default is 1.

       -m|--audio-mute
	      Mute audio.

       --device-type=TYPE
	      Type of input device: default, firewire, or x11.

       --device-frame-size=WxH
	      If the input is a device, request the given frame size, e.g. 640x480.

       --device-frame-rate=N/D
	      If the input is a device, request the given frame rate, e.g. 25/1.

       --device-format=FORMAT
	      Request format default or mjpeg from device.

       --read-commands=FILE
	      Read commands from file.

       --lirc-config=FILE
	      Use the given LIRC configuration file. This option can be used more than once.

       --quality=Q
	      Set rendering quality, from 0 (fastest) to 4 (best, default).

       -v|--video=STREAM
	      Select video stream (1-n, depending on the input).

       -a|--audio=STREAM
	      Select audio stream (1-n, depending on the input).

       -s|--subtitle=STREAM
	      Select subtitle stream (1-n, depending on the input).

       -i|--input=TYPE
	      Select input type.

	      mono   Single view.

	      separate-left-right
		     Left/right view in separate streams, left first.

	      separate-right-left
		     Left/right view in separate streams, right first.

	      alternating-left-right
		     Left/right alternating, left first.

	      alternating-right-left
		     Left/right alternating, right first.

	      top-bottom
		     Left view top, right view bottom.

	      top-bottom-half
		     Left view top, right view bottom, half height.

	      bottom-top
		     Left view bottom, right view top.

	      bottom-top-half
		     Left view bottom, right view top, half height.

	      left-right
		     Left view left, right view right.

	      left-right-half
		     Left view left, right view right, half width.

	      right-left
		     Left view right, right view left.

	      right-left-half
		     Left view right, right view left, half width.

	      even-odd-rows
		     Left view even rows, right view odd rows.

	      odd-even-rows
		     Left view odd rows, right view even rows.

	      The  default  is	to autodetect the input type from meta data stored in the file.  If this fails, Bino tries to autodetect the input
	      type based on the file name, by looking at the last part of the file name before the file name extension (.ext). If that fails, too,
	      Bino guesses based on the resolution of the input.
	      The following file name forms are recognized:

	      *-lr.ext
		     left-right

	      *-lrh.ext or *-lrq.ext
		     left-right-half

	      *-rl.ext
		     left-right swapped

	      *-rlh.ext or *-rlq.ext
		     left-right-half swapped

	      *-tb.ext or *-ab.ext
		     top-bottom

	      *-tbh.ext or *-abq.ext
		     top-bottom-half

	      *-bt.ext or *-ba.ext
		     top-bottom swapped

	      *-bth.ext or *-baq.ext
		     top-bottom-half swapped

	      *-eo.ext or *-eoq.ext or *-3dir.ext
		     even-odd-rows

	      *-oe.ext or *-oeq.ext or *-3di.ext
		     even-odd-rows swapped

	      *-2d.ext
		     mono

       -o|--output=TYPE
	      Select output type.

	      stereo OpenGL quad-buffer stereo.

	      alternating
		     Left and right view alternating.

	      mono-left
		     Left view only.

	      mono-right
		     Right view only.

	      top-bottom
		     Left view top, right view bottom.

	      top-bottom-half
		     Left view top, right view bottom, half height.

	      left-right
		     Left view left, right view right.

	      left-right-half
		     Left view left, right view right, half width.

	      even-odd-rows
		     Left view even rows, right view odd rows.

	      even-odd-columns
		     Left view even columns, right view odd columns.

	      checkerboard
		     Left and right view in checkerboard pattern.

	      hdmi-frame-pack
		     HDMI  frame  packing mode (left top, right bottom, plus extra blank lines separating the two views). This mode is only neces-
		     sary if you are forcing your display into the corresponding HDMI 3D mode.

	      red-cyan-monochrome
		     Red/cyan anaglyph, monochrome method.

	      red-cyan-half-color
		     Red/cyan anaglyph, half color method.

	      red-cyan-full-color
		     Red/cyan anaglyph, full color method.

	      red-cyan-dubois
		     Red/cyan anaglyph, high-quality Dubois method.

	      green-magenta-monochrome
		     Green/magenta anaglyph, monochrome method.

	      green-magenta-half-color
		     Green/magenta anaglyph, half color method.

	      green-magenta-full-color
		     Green/magenta anaglyph, full color method.

	      green-magenta-dubois
		     Green/magenta anaglyph, high-quality Dubois method.

	      amber-blue-monochrome
		     Amber/blue anaglyph, monochrome method.

	      amber-blue-half-color
		     Amber/blue anaglyph, half color method.

	      amber-blue-full-color
		     Amber/blue anaglyph, full color method.

	      amber-blue-dubois
		     Amber/blue anaglyph, high-quality Dubois method.

	      red-green-monochrome
		     Red/green anaglyph, monochrome method.

	      red-blue-monochrome
		     Red/blue anaglyph, monochrome method.

	      equalizer
		     Multi-display OpenGL via Equalizer with a 2D canvas setup.

	      equalizer-3d
		     Multi-display OpenGL via Equalizer with a 3D screen setup.

	      For stereo input, the default is stereo if the display supports it,  otherwise  red-cyan-dubois.	The  default  for  mono  input	is
	      mono-left.

       -S|--swap-eyes
	      Swap left/right view.

       -f|--fullscreen
	      Fullscreen.

       --fullscreen-screens=[S0[,S1[,...]]]
	      Use the listed screens S0, ..., Sn in fullscreen mode. Screen numbers start with 1. If the list is empty, the primary screen will be
	      used (this is the default).

       --fullscreen-flip-left
	      Flip left view vertically when in fullscreen mode.

       --fullscreen-flop-left
	      Flop left view horizontally when in fullscreen mode.

       --fullscreen-flip-right
	      Flip right view vertically when in fullscreen mode.

       --fullscreen-flop-right
	      Flop right view horizontally when in fullscreen mode.

       --fullscreen-3dr-sync
	      Use DLP(R) 3-D Ready Sync when in fullscreen mode.

       -z|--zoom=Z
	      Set zoom for videos that are wider than the screen, from 0 (off; show full video width) to 1 (full; use  full  screen  height).  The
	      default is 0.

       -C|--crop=W:H
	      Crop the video to the given aspect ratio, to remove borders. 0:0 disables cropping.

       -c|--center
	      Center window on screen.

       --subtitle-encoding=ENC
	      Set subtitle encoding.

       --subtitle-font=FONT
	      Set subtitle font name.

       --subtitle-size=N
	      Set subtitle font size.

       --subtitle-scale=S
	      Set subtitle scale factor.

       --subtitle-color=COLOR
	      Set subtitle color, in [AA]RRGGBB format.

       --subtitle-shadow=-1|0|1
	      Set subtitle shadow, -1=default, 0=off, 1=on.

       --subtitle-parallax=VAL
	      Subtitle parallax adjustment (-1 to +1).

       -P|--parallax=VAL
	      Parallax adjustment (-1 to +1).

       --crosstalk=VAL
	      Crosstalk leak level (0 to 1). Comma-separated values for the R,G,B channels.

       --ghostbust=VAL
	      Amount of crosstalk ghostbusting to apply (0 to 1).

       -b|--benchmark
	      Benchmark mode: no audio, no time synchronization, output of frames-per-second measurements.

       --swap-interval=D
	      Frame rate divisor relative to display refresh rate. The default is 0 for benchmark mode and 1 otherwise.

       -l|--loop
	      Loop the input media.

INTERACTIVE CONTROL

       ESC    Leave fullscreen mode, or quit when in window mode.

       q      Quit.

       p or SPACE
	      Pause / unpause.

       f      Toggle fullscreen.

       c      Center window.

       e or F7
	      Swap left/right eye.

       v      Cycle through available video streams.

       a      Cycle through available audio streams.

       s      Cycle through available subtitle streams.

       1, 2   Adjust contrast.

       3, 4   Adjust brightness.

       5, 6   Adjust hue.

       7, 8   Adjust saturation.

       [, ]   Adjust parallax.

       (, )   Adjust ghostbusting.

       <, >   Adjust zoom for videos that are wider than the screen.

       /, *   Adjust audio volume.

       m      Toggle audio mute.

       .      Step a single video frame forward.

       left, right
	      Seek 10 seconds backward / forward.

       down, up
	      Seek 1 minute backward / forward.

       page down, page up
	      Seek 10 minutes backward / forward.

       Mouse click
	      Seek according to the horizontal click position.

       Media Keys
	      Media keys (if available) should work as expected.

AUTHORS

       The Bino developers.

SEE ALSO

       ffmpeg(1)

								      2012-06								   Bino(1)