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.6.0 or 1.4.4 cannot play your video even with quality set to zero. Please note that color rendering is not 100% exact in this version.

Known bugs

The movie stops playing when I click on the menubar. This is a bug due to Qt/Mac, which is still present in recent Qt releases (at least up to version 5.0.2).

The whole interface freezes when selecting menus. Try clicking on the window title bar. Also try to use keyboard menu navigation when the mouse doesn't work: arrows to move, return to select, esc to close menus. This is also a random Qt/Mac bug.

Frequently asked questions (FAQ)

The video does not play smoothly, does that mean I have to upgrade my computer or graphics card?
Bino will run on most computers, as long as they are able to decode the video smoothly. Try playing the video (in 2D) with another video player such as VLC. If VLC can play it, try setting the quality in Bino's preferences to a lower value. If it cannot play your video even with the quality set to 0 (zero), try the older 0.6.20101210 version.

How do I play a video file with separate subtitles on the Mac?
Select the menu File->Open files.. (you should get a dialog window which tells you you can open multiple files).
In the file selection dialog, select the mkv and the srt with cmd-click. Select the subtitle track in the main bino interface.
Note that you cannot open multiple files with Bino from the Finder (right click -> Open with...) due to a Qt bug/limitation on the mac.

Can I get Bino on the Mac with Equalizer (multi-screen) support?
Unfortunately, Equalizer cannot be built on the Mac with the native interface, because it only supports the Carbon API, which is deprecated. It should be possible to build an X11-based Bino (with Qt/X11 and Equalizer/X11), but I haven't tried it yet (because MacPorts doesn't let me have Qt/Mac and Qt/X11 installed simultaneously)

Here are instructions that can be used to build Bino with MacPorts (HomeBrew instructions are below). 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

Download and install Xcode tools (the links work if you [sign in to Apple Developer](https://developer.apple.com/downloads/) first):

Uncompress the portfiles in a directory of your choice. In the following, we suppose you uncompressed it in /Users/USER_NAME/Development/dports-dev, but it can be anywhere except in the Documents directory, which has special permissions.

Give read/execute permissions to the local repository: "chmod 755 /Users/USER_NAME/Development/dports-dev"

Check that the user "nobody" can read this directory by typing the following command in a Terminal: "sudo -u nobody ls /Users/USER_NAME/Development/dports-dev". If it fails, then try again after having given execution permissions on your home directory using the following command: "chmod o+x /Users/USER_NAME". If this still fails, then something is really wrong.

Edit the sources.conf file for MacPorts, for example using the nano editor: "sudo nano /opt/local/etc/macports/sources.conf", insert at the beginning of the file the configuration for a local repository (read the comments in the file), by inserting the line "file:///Users/USER_NAME/Development/dports-dev" (without quotes, and yes there are 3 slashes). Save and exit (if you're using nano, this means typing ctrl-X, Y and return).

Update MacPorts: "sudo port selfupdate"

Recreate the index in the local repository: "cd /Users/USER_NAME/Development/dports-dev; portindex" (no need to be root for this)

Compiling and installing

sudo port install bino +app +openalsoft +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).

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:

+app build a standalone application rather than a command-line tool

+openalsoft compile against the OpenAL-soft port to MacOSX, which enables multi-channel audio extensions

+debug enable debugging code

Compiling from Bino source distribution

To compile Bino from source using MacPorts, 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

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

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:

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"

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"