1Bino(1) Version 2.1 Bino(1)
2
6 Bino is a video player with a focus on 3D and Virtual Reality:
7 • Support for stereoscopic 3D videos in various formats
9 • Support for 360° and 180° videos, with and without stereoscopic 3D
11 • Support for Virtual Reality environments, including SteamVR, CAVEs,
13 powerwalls, and other multi-display / multi-GPU / multi-host systems
14
16 bino [options] URL...
17 • -h, --help
19 Displays help on commandline options.
21 • --help-all
23 Displays help including Qt specific options.
25 • -v, --version
27 Displays version information.
29 • --log-level level
31 Set log level (fatal, warning, info, debug, firehose).
33 • --log-file file
35 Set log file.
37 • --read-commands script
39 Read commands from a script file. See Scripting.
41 • --opengles
43 Use OpenGL ES instead of Desktop OpenGL.
45 • --stereo
47 Use OpenGL quad-buffered stereo in GUI mode.
49 • --vr
51 Start in Vitrual Reality mode instead of GUI mode. See Virtual Real‐
53 ity.
54 • --vr-screen screen
56 Set VR screen geometry, either as a comma-separated list of nine val‐
58 ues representing three 3D coordinates that define a planar screen
59 (bottom left, bottom right, top left) or as a name of an OBJ file
60 that contains the screen geometry with texture coordinates.
61 • --capture
63 Capture video/audio input from camera and microphone.
65 • --list-audio-outputs
67 List audio outputs.
69 • --list-audio-inputs
71 List audio inputs.
73 • --list-video-inputs
75 List video inputs.
77 • --audio-output ao
79 Choose audio output via its index.
81 • --audio-input ai
83 Choose audio input via its index. Can be empty.
85 • --video-input vi
87 Choose video input via its index.
89 • --list-tracks
91 List all video, audio and subtitle tracks in the media.
93 • --preferred-audio lang
95 Set preferred audio track language (en, de, fr, ...).
97 • --preferred-subtitle lang
99 Set preferred subtitle track language (en, de, fr, ...). Can be emp‐
101 ty.
102 • --video-track track
104 Choose video track via its index.
106 • --audio-track track
108 Choose audio track via its index.
110 • --subtitle-track track
112 Choose subtitle track via its index. Can be empty.
114 • -i, --input mode
116 Set input mode (mono, top-bottom, top-bottom-half, bottom-top, bot‐
118 tom-top-half, left-right, left-right-half, right-left, right-left-
119 half, alternating-left-right, alternating-right-left).
120 • -o, --output mode
122 Set output mode (left, right, stereo, alternating, red-cyan-dubois,
124 red-cyan-full-color, red-cyan-half-color, red-cyan-monochrome, green-
125 magenta-dubois, green-magenta-full-color, green-magenta-half-color,
126 green-magenta-monochrome, amber-blue-dubois, amber-blue-full-color,
127 amber-blue-half-color, amber-blue-monochrome, red-green-monochrome,
128 red-blue-monochrome, even-odd-rows, even-odd-columns, checkerboard).
129 • --surround mode
131 Set surround mode (360, 180, off).
133 • -S, --swap-eyes
135 Swap left/right eye.
137 • -f, --fullscreen
139 Start in fullscreen mode.
141
143 Bino can read commands from a script file and execute them via the op‐
144 tion --read-commands scriptfile. This works both in GUI mode and in
145 Virtual Reality mode.
146 The script file can also be a named pipe so that you can have arbitraty
148 remote control interfaces write commands into it as they come in.
149 Empty lines and comment lines (which begin with #) are ignored. The
151 following commands are supported:
152 • open [--input mode] [--surround mode] [--video-track vt] [--audio-
154 track at] [--subtitle-track st] URL
155 Open the URL and start playing. The options have the same meaning as
157 the corresponding command line options.
158 • capture [--audio-input ai] [--video-input vi]
160 Start capturing camera and microphone. The options have the same
162 meaning as the corresponding command line options.
163 • play
165 Start playing.
167 • pause
169 Pause.
171 • toggle-pause
173 Switch between pause and play.
175 • stop
177 Stop playing.
179 • playlist-next
181 Switch to next playlist entry.
183 • playlist-prev
185 Switch to previous playlist entry.
187 • playlist-loop mode
189 Set loop mode (off, one, all).
191 • quit
193 Quit Bino.
195 • set-position p
197 Set the video position to p, where p=0 is the beginning and p=1 is
199 the end.
200 • seek seconds
202 Seek the given amounts of seconds forward or, if the number of sec‐
204 onds is negative, backwards.
205 • wait stop|seconds
207 Wait until the video stops, or wait for the given number of seconds,
209 before executing the next command.
210 • set-mute on|off
212 Set the volume mute status.
214 • toggle-mute
216 Switch between mute and unmute.
218 • set-volume vol
220 Set the volume level to vol (between 0 and 1).
222 • adjust-volume offset
224 Adjust the volume by the given amount (the final volume is clamped
226 between 0 and 1).
227 • set-output-mode mode
229 Set the given output mode. See the command line option --output for
231 a list of modes.
232 • set-swap-eyes on|off
234 Set left/right eye swap.
236 • toggle-swap-eyes
238 Toggle left/right eye swap.
240 • set-fullscreen on|off
242 Set fullscreen mode.
244 • toggle-fullscreen
246 Toggle fullscreen mode.
248
250 Bino currently cannot detect the stereoscopic layout or the surround
251 video mode from metadata because Qt does not provide that information.
252 It therefore has to guess.
253 Bino recognizes the following hints at the last part of the file name,
255 just before the file name extension (.ext):
256 • *-tb.ext, *-ab.ext: Input mode top-bottom
258 • *-tbh.ext, *-abq.ext: Input mode top-bottom-half
260 • *-bt.ext, *-ba.ext: Input mode bottom-top
262 • *-bth.ext, *-baq.ext: Input mode bottom-top-half
264 • *-lr.ext: Input mode left-right
266 • *-lrh.ext, *-lrq.ext: Input mode left-right-half
268 • *-rl.ext: Input mode right-left
270 • *-rlh.ext, *-rlq.ext: Input mode right-left-half
272 • *-2d.ext: Input mode mono
274 Additionally, if the number 180 or 360 is part of the file name and
276 separated by neighboring digits or letters by other characters, then
277 the corresponding surround mode is assumed.
278
280 Bino supports all sorts of Virtual Reality environments via QVR
281 (https://marlam.de/qvr):
282 • When QVR is compiled with just with Qt6, CAVEs and powerwalls and
284 similar multi-display setups are supported, including multi-GPU and
285 multi-host rendering.
286 • When QVR is additionally compiled with VRPN
288 (https://github.com/vrpn/vrpn), all sorts of tracking and interaction
289 hardware for such systems are supported.
290 • When QVR is additionally compiled with OpenVR
292 (https://github.com/ValveSoftware/openvr), SteamVR is supported and
293 automatically detected (e.g. HTC Vive).
294 To start Bino in VR mode, use the option --vr. Bino will then display
296 a screen in the virtual world, and the video will be displayed on that
297 screen, unless the input is a surround video (360° or 180°), which will
298 of course be displayed all around the viewer.
299 The default is a 16:9 screen in a few meters distance from the viewer,
301 but you can use the --vr-screen option to either define arbitrary pla‐
302 nar screens via their bottom left, bottom right and top left corners,
303 or to load arbitrary screen geometry from an OBJ file. The latter case
304 is useful e.g. if you want Bino’s virtual screen to coincide with a
305 curved physical screen.
306 Bino uses QVRs default navigation, which may be based on autodetected
308 controllers such as the HTC Vive controllers, or on tracking and inter‐
309 action hardware configured via QVR for your VR system, or on the mouse
310 and WASDQE keys if nothing else is available.
311 Additional interaction in VR mode is currently limited to the same key‐
313 board shortcuts that also work in GUI mode. That means you currently
314 must specify the video to play on the command line, and have no way to
315 pause, skip or seek – this will be added in a future version.
316 February 1, 2023 Bino(1)