Tux Linux logo

Download BORIS for GNU/Linux

Please acknowledge and cite the use of this software and its authors when results are used in publications or published elsewhere:

Friard, O. and Gamba, M. (2016), BORIS: a free, versatile open-source event-logging software for video/audio coding and live observations. Methods Ecol Evol, 7: 1325–1330.


The version 7 of BORIS is available.

This version introduces various new features:

  • possibility to play up to 8 media simultaneously
  • usage of lower case keys to code behaviors, subjects and modifiers.
  • export the coded events for analysis with JWatcher
  • an improved exclusion matrix manager ...
  • A filter for coded events
  • ...

Please note that the projects created with v. 7 will NOT be compatible with versions older than v. 7

Please test and report any bugs and regression!

See the revision history for details: https://github.com/olivierfriard/BORIS/wiki/BORIS-revision-history

The user guide is available at https://boris.readthedocs.io

BORIS for linux 64-bit v.7.9.7

BORIS requires the installation of the VLC media player

BORIS for Linux 64-bit v.7.9.7

For older distributions (like Ubuntu 16.04 or Ubuntu 14.04):

BORIS for Linux 64-bit v.7.9.7 for older versions

Download, uncompress the archive and launch boris

BORIS for Linux 32-bit is no more available due to the fact that Qt is not available for 32 bits. If you are using Linux at 32-bit you must run BORIS from sources.


If you are using Ubuntu and VLC is pre-installed via snap you have to uninstall it. Open a terminal and type:

sudo snap remove vlc

To check if VLC is installed via snap on your system, open a terminal and type:

snap list

To install VLC via apt, open a terminal and type:

sudo apt-get install vlc

Run from sources


The requirements for running BORIS from the source code are:

Python 3.6+,

PyQt5 for Python3,

the VLC media player,

the FFmpeg framework,

the Matplotlib Python library

the Tablib Python library

the python-intervals Python library

If you want to generate transition flow graphs directly from BORIS you have to install the Graphviz package (not mandatory).

Install these packages following the instructions relative to your distribution:

Example for Debian based distributions like Ubuntu, Kubuntu, Xubuntu ...:

For Debian, open a terminal and type:

su (your root password will be required)
apt install vlc ffmpeg graphviz python3-pip

For Ubuntu and Ubuntu like:

sudo apt install vlc ffmpeg graphviz python3-pip
(your root password will be required)

It is recommended to create a Python virtual environment to do not interfere with the Python modules installed on your system:

pip3 -m venv boris_virtual_env

Activate the virtual environment:

source boris_virtual_env/bin/activate

Install the required Python modules with pip:

python3 -m pip install pyqt5 numpy matplotlib tablib python-intervals

Download the BORIS source code:

wget https://github.com/olivierfriard/BORIS/archive/v7.9.7.tar.gz

Unpack the archive:

tar xvf v7.9.7.tar.gz

Launch BORIS:

cd BORIS-7.9.7
python3 boris.py