Skip to content
App for scoring behaviours of whatever, in videos.
Python Makefile
Branch: master
Clone or download
Fetching latest commit…
Cannot retrieve the latest commit at this time.
Type Name Latest commit message Commit time
Failed to load latest commit information.


ScoreBee is a GUI tool for scoring videos. It was designed to score behaviour for a biology research project.

ScoreBee is quite functional, but is not considered a polished product, and so comes with a number of caveats:

  • It uses an external video player that it must continuously syncronize with. All data collection performs such a sync, and so the data is correct, but the interface is occasionally disconcerting as time seems to "jump" around slightly.

  • Time is represented as a count of frames. This might be a problem with your research if you have a variable speed video source, and your frames are not the same length.

  • There is no GUI for editing the tracks you are scoring, not the templates; one must edit the template defitions.

There are plans to replace the external video player with an embedded one, to add missing critical features, and to stomp a few bugs, but there is no timeline in place.


ScoreBee's requirements are:

On OS X (with HomeBrew), installation is roughly:

# Install QT4, PyQt4 and sip
brew install pyqt

# Install mplayer, and (re)build the font cache.
brew install mplayer

# Make sure mplayer works.
# Note: the first time MPlayer OSX plays a video, fontconfig will build it's
# font cache. This can take a while but only has to be done once.
mplayer /path/to/some/

# Grab ScoreBee itself (if you are reading this on GitHub).
git clone
cd ScoreBee

To run ScoreBee (on OS X):

# Pull PyQt4 and sip into the shell's environment
export PYTHONPATH="/usr/local/opt/pyqt/lib/python2.7/site-packages:/usr/local/opt/sip/lib/python2.7/site-packages"
export PATH="$PATH:/usr/local/opt/pyqt/bin"

# Run ScoreBee.
make run

You can’t perform that action at this time.