App for scoring behaviours of whatever, in videos.
Python Makefile
Switch branches/tags
Nothing to show
Clone or download
Fetching latest commit…
Cannot retrieve the latest commit at this time.
Permalink
Failed to load latest commit information.
scorebee
settings
ui
.gitignore
CHANGELOG.txt
LICENSE.txt
Makefile
README.md
TODO.txt

README.md

ScoreBee

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.

Installation

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/video.mov

# Grab ScoreBee itself (if you are reading this on GitHub).
git clone git@github.com:mikeboers/ScoreBee
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