Bino: free stereoscopic 3D video player (Mac OS X binaries)

Precompiled binaries

Version 0.6.20101210 is the last version that doesn't use OpenGL Shaders - try this one if you have a MacBook (pre-10/2007), Mac Mini or iMac (pre 03/2009) with an Intel GMA950 graphics chipset, or if Bino 1.4.1 cannot play your video even with quality set to zero. Please note that color rendering is not 100% exact in this version.

Known bugs

Frequently asked questions (FAQ)

Building using MacPorts

Here are instructions that can be used to build Bino with MacPorts. To compile Bino this way, must have administration rights on your Mac, and you have to know how to use MacPorts and the Terminal application.

Setting up MacPorts

Compiling and installing

sudo port install bino +app +openalsoft +qt4nokia +no_x11 +dc1394 +quartz

The +no_x11 and +quartz flags are used for installing cairo and pango libs, which FFmpeg and Bino depend on, with Quartz support but without X11; the +dc1394 enables firewire camera support in FFmpeg (and Bino). Add +universal if you want a universal binary, i.e. PPC/i386 on Leopard, or i386/x86_64 on Snow Leopard (OS X Lion and later versions only run on 64-bits machines, so a universal port would be useless on these).

On Leopard and Snow Leopard, bino should be installed with Qt4 built by MacPorts, so the +qt4nokia variant should be disabled:

sudo port install bino +app +openalsoft +no_x11 +dc1394 +quartz

The resulting application is installed in /Applications/MacPorts, and it can be redistributed (it doesn't contain links to locally installed libraries or frameworks, and it is redistributable under the GPL v3 license).

The Bino Portfile has the following variants:

If you want to compile bino with Qt4 from MacPorts (not from Nokia) and get a standalone application (+app variant), you have to install the qt4-mac port with the variant +framework (building the application uses the macdeployqt utility from Qt, which does not work in the non-framework version):

sudo port install qt4-mac +no_x11 +quartz +framework

sudo port install bino +app +openalsoft +no_x11 +dc1394 +quartz -qt4nokia

Compiling from Bino source distribution

To compile Bino from source, first install the required dependencies (add the +universal argument on 10.5 or 10.6 if you intend to build a universal binary):

$ sudo port install texinfo

$ sudo port install ffmpeg +dc1394 +no_x11 (the +no_x11 flags prevents SDL from installing all the X11 libraries which are not needed)

$ sudo port install glew

$ sudo port install libass

$ sudo port install qt4-mac +framework (only recommended on 10.5 and 10.6 - 10.7 and later may use the Qt 4.8.3 distribution from Nokia)

Change to the directory where you want to put the bino sources, and checkout and configure the source using the following commands:

$ git clone git://git.savannah.nongnu.org/bino.git

$ cd bino

$ autoreconf -i

$ ./configure --prefix=/opt/local LDFLAGS=-L/opt/local/lib CPPFLAGS=-I/opt/local/include libqtopengl_LIBS="-framework QtCore -framework QtGui -framework QtOpenGL -framework OpenGL" libqtopengl_CFLAGS="-I/Library/Frameworks/QtCore.framework/Headers -I/Library/Frameworks/QtGui.framework/Headers -I/Library/Frameworks/QtOpenGL.framework/Headers" libgl_LIBS="-framework OpenGL -framework IOKit" libgl_CFLAGS="-I/Library/Frameworks/OpenGL.framework/Headers"

Or if you are compiling against qt4-mac installed by MacPorts with the +framework variant (preferred configuration on Mac OS X 10.5 and 10.6):

$ ./configure --prefix=/opt/local LDFLAGS=-L/opt/local/lib CPPFLAGS=-I/opt/local/include libqtopengl_LIBS="-F/opt/local/Library/Frameworks -framework QtCore -framework QtGui -framework QtOpenGL -framework OpenGL" libqtopengl_CFLAGS="-F/opt/local/Library/Frameworks -I/opt/local/Library/Frameworks/QtCore.framework/Headers -I/opt/local/Library/Frameworks/QtGui.framework/Headers -I/opt/local/Library/Frameworks/QtOpenGL.framework/Headers" libgl_LIBS="-framework OpenGL -framework IOKit" libgl_CFLAGS="-I/Library/Frameworks/OpenGL.framework/Headers"

You can add --enable-debug to add debugging and checking code.

To build a "universal" binary, which is really only useful on 10.5 (on which universal means i386/PPC) and 10.6 (i386/x86_64), you should add to the configure command like above the argument CXXFLAGS="-arch i386 -arch ppc" on 10.5, or CXXFLAGS="-arch i386 -arch x86_64" on 10.6. Note that all the MacPorts dependencies must also be installed with the +universal variant.

On Mac OS X Leopard (10.5), you should also add at the end of the configure command line CC=gcc-4.2 CXX=g++-4.2, because the system default compiler (GCC 4.0) doesn't support atomic builtins.

$ make

The command above compiles and links the bino binary, which can be found in src/bino, and if you want to make a standalone and redistributable application, you can use the following command:

$ make package-macosx

Check that the resulting binary is standalone: it should not point to libraries in /opt/local:

$ otool -L Bino.app/Contents/MacOS/Bino

The resulting Bino.app is in the currect directory:

$ open Bino.app

The command-line version is hidden inside:

$ ./Bino.app/Contents/MacOS/Bino

If lanching the application doesn't work, and launching the command-line version complains about a missing qt_menu.nib (it happens when compiling against the non-framework version of qt4-mac), copy the nib:

$ cp -r /opt/local/lib/Resources/qt_menu.nib ./Bino.app/Contents/Resources

If you want to compile with Apple OpenAL (for which Bino does not support multichannel audio), you should add to the configure flags: libopenal_LIBS="-framework OpenAL" libopenal_CFLAGS="-F/System/Library/Frameworks"

License

Bino is free software, licensed under the terms of the GNU GPL version 3 or later.


Frederic Devernay

Valid XHTML 1.1! Valid CSS! Level Double-A conformance icon, 
          W3C-WAI Web Content Accessibility Guidelines 1.0