BORIS (Behavioral Observation Research Interactive Software)
BORIS is an easy-to-use event logging software for video/audio coding or live observations.
BORIS is a free and open-source software available for GNU/Linux, Windows and macOS.
It provides also some analysis tools like time budget and some plotting functions.
Video playback on macOS
On macOS, BORIS displays video inside its player panels using libmpv and OpenGL. Install mpv (including libmpv) and FFmpeg with Homebrew:
brew install mpv ffmpeg
If libmpv is unavailable, BORIS uses separate mpv windows through IPC. This mode
can also be selected with --ipc (-i). IPC diagnostic messages are written to
/tmp/mpvsocket<N>.log to prevent unread output pipes from blocking playback.
Panels can be moved, floated, and docked again. Use Tools > Lock dockwidgets to
lock them. Hardware decoding set to auto or auto-safe uses VideoToolbox
copy-back so that frame extraction and geometric measurements remain available.
On macOS, arrow keys reported with the numeric keypad modifier are normalized for navigation and behavior shortcuts. To show or hide columns in the Ethogram, Subjects, or Events tables, right-click the table header or choose Configure columns from the table menu. Column visibility is saved between sessions.
The BORIS paper has more than 2931 citations in peer-reviewed scientific publications.
See the official BORIS web site.
Documentation
The user guide provides a good starting point for learning how to use BORIS.
Some video tutorials are available.
Bug reports and feature requests
To search for bugs, report them or request a feature, please use the GitHub issues tracker
Citing BORIS
Please acknowledge and cite the use of this software and its authors when results are used in publications or published elsewhere. You can use the following BibTex entry
@article {MEE3:MEE312584,
author = {Friard, Olivier and Gamba, Marco},
title = {BORIS: a free, versatile open-source event-logging software for video/audio coding and live observations},
journal = {Methods in Ecology and Evolution},
issn = {2041-210X},
url = {http://dx.doi.org/10.1111/2041-210X.12584},
doi = {10.1111/2041-210X.12584},
pages = {1324--1330},
year = {2016},
}
You can also send us a nice postcard! See the user testimonials.
Licence
This program is distributed in the hope that it will be useful, but WITHOUT ANY WARRANTY; without even the implied warranty of MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the GNU General Public License for more details.
Distributed with a GPL v.3 license.
Copyright (C) 2012-2025 Olivier Friard
1 maintainer
Metadata
1 maintainer
Release files for boris-behav-obs 10.0.2
For a detailed explanation of source distributions (sdists) and built distributions (wheels), please see the package formats documentation.
Source distribution (sdist)
| File | Size | Uploaded | Provenance | Actions |
|---|---|---|---|---|
| boris_behav_obs-10.0.2.tar.gz | 984.7 kB | Without provenance | Details for boris_behav_obs-10.0.2.tar.gz |
Built distribution (wheel)
| File | Interpreter | ABI | Platform | Actions Reset |
|---|---|---|---|---|
| boris_behav_obs-10.0.2-py3-none-any.whl | Python 3 | none | any | Details for boris_behav_obs-10.0.2-py3-none-any.whl |
Total release size: 2.0 MB
Release files / boris_behav_obs-10.0.2.tar.gz
| Download URL | boris_behav_obs-10.0.2.tar.gz |
|---|---|
| Size | 984.7 kB |
| Tags | Source |
|
SHA-256 checksum How to use checksums |
ca6dd205011cb7eb05aa97949c36d572b333e4820d63bb70efe1b47846757840
|
|
BLAKE2b-256 checksum How to use checksums |
ed2ae10b54858352e369729b660655a60c3fe8195602bff726e13b678b0f3c46
|
| Upload date | |
|
Uploaded using Trusted Publishing? What is trusted publishing? |
No |
| Uploaded via |
uv/0.13.1 {"installer":{"name":"uv","version":"0.13.1","subcommand":["publish"]},"python":null,"implementation":{"name":null,"version":null},"distro":{"name":"Linux Mint","version":"22.3","id":"zena","libc":null},"system":{"name":null,"release":null},"cpu":null,"openssl_version":null,"setuptools_version":null,"rustc_version":null,"ci":null}
|
Release files / boris_behav_obs-10.0.2-py3-none-any.whl
| Download URL | boris_behav_obs-10.0.2-py3-none-any.whl |
|---|---|
| Size | 1.0 MB |
| Tags | Python 3 |
|
SHA-256 checksum How to use checksums |
e73225cb99efe73dda9383a83e7cd09413555eface2064d76478cd0e42eebec1
|
|
BLAKE2b-256 checksum How to use checksums |
dc4928751548269ae427cc42c6ce6b918b4f8229998097fe89de12176146dd75
|
| Upload date | |
|
Uploaded using Trusted Publishing? What is trusted publishing? |
No |
| Uploaded via |
uv/0.13.1 {"installer":{"name":"uv","version":"0.13.1","subcommand":["publish"]},"python":null,"implementation":{"name":null,"version":null},"distro":{"name":"Linux Mint","version":"22.3","id":"zena","libc":null},"system":{"name":null,"release":null},"cpu":null,"openssl_version":null,"setuptools_version":null,"rustc_version":null,"ci":null}
|
Security for boris-behav-obs 10.0.2
Provenance
Provenance describes where a file came from. On PyPI, provenance is shared via attestations, which provide a verifiable record of the build or publishing details. View details, limitations and caveats.
No provenance found
None of the files in this release were uploaded with provenance metadata.
A note on package security
PyPI is a repository for distributing packages, not a service for auditing them. While third-party security researchers and our staff do their best to detect and remove malicious packages, PyPI cannot guarantee the quality, security or suitability of any given package.
To learn more about protecting yourself from malicious actors, visit our package security documentation.
