Download
EXTREMELY IMPORTANT
BORIS is distributed WITHOUT ANY WARRANTY.
Please remember that it is extremely important to regularly back up your project files to prevent data loss.
While software can be reinstalled, your data might be lost forever if not properly backed up.
Use an external drive and/or a cloud service for your backups.
Include a timestamp in the file name to avoid overwriting previous backups (e.g., my_project.YYYY-MM-DD.boris).
Current version: v. 9.3.2 release date: 2025-04-14
The user guide is available at https://www.boris.unito.it/user_guide. Feel free to contact me if you want to improve it.
Refer to the change log for a detailed summary of version updates.
Kindly acknowledge and properly cite this software and its authors when using the results in publications or other forms of dissemination:
Friard, O. and Gamba, M.,
BORIS: a free, versatile open-source event-logging software for video/audio coding and live observations.
(2016) Methods Ecol Evol, 7: 1325–1330.
DOI: 10.1111/2041-210X.12584
http://onlinelibrary.wiley.com/doi/10.1111/2041-210X.12584/abstract
If you find this software useful, please send me a nice postcard of the place where do you live.
GNU-Linux
Microsoft-Windows
MacOS
BORIS App for Android
Raspberry Pi 4
Chromebook
VirtualBox virtual machine
Docker image
Install from the Python Package Index (Linux)
Download sources
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.
Suggestions and general discussion
Test - video samples
You can download video samples to test BORIS on your system:
video_samples.zip (~ 70 Mb)
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!
Credits
BORIS is developed entirely with open source software.
BORIS is developped in Python 3.12 using PySide6 for the GUI.
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 (optional).
The Graphviz graph visualization software is used (optional) to generate transitions graph.
The BORIS web site is made using Material for Mkdocs static site generator and supported by GitHub.