BORIS is a free and open-source software, and is released under the GNU General Public License.

Current version: v. 8.20.3

The user guide is available at . Feel free to contact me if you want to improve it.

BORIS is distributed WITHOUT ANY WARRANTY. Remember that it is EXTREMELY important to do regular backups of your project files to prevent the lost of data. Software can be reinstalled but your data could quite possibly be lost for ever.

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.


If you find this software useful, please send me a nice postcard of the place where do you live.

The v. 8 has great improvements due to the use of the mpv media player (, see version 8 for the details.

Docker logo Docker image

See the revision history for details:

All files are signed with GPG you can verify their integrity using my PGP public key.

Bug report, feature request and discussion

See the how to report a bug page.

GitHub feature request.

Suggestions and general discussion

Test - video samples

You can download video samples to test BORIS on your system:

Previous versions

All previous versions of BORIS are available in the BORIS releases archive or in the BORIS archive for versions prior to 2.99. Please note that the backward compatibility of a BORIS project is not guaranteed!


BORIS is developed entirely with open source software.

BORIS is developped in Python 3.10 using PyQt5 for the GUI (should run from Python >= 3.8).
The mpv media player library and the python-mpv interface are used to play media files.
The Matplotlib python 2D plotting library is used for plotting events and generating the spectrogram.
The Pandas data analysis tool.
The FFmpeg multimedia framework is used to extract media files parameters, in frame-by-frame mode and in spectrogram visualization.
The Tablib Python module is used to export data in TSV, CSV, ODS, XLSX, HTML and XLS formats.
The portion Python module is used in the Advanced event filtering function.
The ExifRead Python module used to access pictures Exif data.
The pyreadr Python module is used to save data for R (optionally).
The Graphviz graph visualization software is used (optionally) to generate transitions graph.
The BORIS web site is made using Pelican static site generator and supported by GitHub.