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

RELATED TO bino…

ffmpeg(1)