boris-clip

Extract video clips from BORIS behavioural annotation files.

For each annotated bout in a BORIS file, boris-clip cuts the corresponding segment from your video and saves it as an individual clip. Clips are named after the source video, behaviour, subject, and time interval — making them easy to sort and identify without opening them.

recording_REM_ind1_10.033-15.766.mp4
recording_grooming_ind2_42.100-48.500.mp4

Quickstart

# Install globally
uv tool install boris-clip

# Run on your .boris project file
boris-clip annotations.boris

Clips are saved to a clips/ directory in the current folder. See the Installation page for all install options, or the Usage guide for more examples.

Contributing

Bug reports and pull requests are welcome on GitHub.

License

MIT