Download

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

The current version of BORIS is 7.9.7

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.

doi:10.1111/2041-210X.12584

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

new logo

Release of v. 7

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

Current version

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!

Test - video samples

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

video_samples.zip (~ 70 Mb)

Bug report and feature request

Bug report

Please report any bug (found in the latest BORIS version) using the GitHub repository or eventually by e-mail (in english, french or italian). Read the FAQ first to check if your problem is already fixed and remember to indicate your OS, your OS version, the BORIS version you are using.

Feature request

For suggestion and feature request please use the GitHub repository or eventually send me an e-mail.

Credits

BORIS is developed entirely with open source software.

BORIS is developped in Python 3.6 using PyQt5 for the GUI.
The VLC Python binding is used to play media files.
The Matplotlib python 2D plotting library is used for plotting events and generating the spectrogram.
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 python-intervals Python module is used in the Advanced event filtering function.
The Graphviz graph visualization software is used (optionally) to generate transitions graph.
BORIS executable files are deployed on Windows, Mac and Linux with PyInstaller
The BORIS web site is made using Pelican static site generator and supported by GitHub.