Bee annotator


Napari plugin for the annotation of bee entering and leaving the hive.

Workflow step:
Image annotation

Developed by the EPFL Center for Imaging for the Mobile Robotic Systems Group in Dec 2023. This napari plugin provides an easy way for the researches to annotate honey bees leaving/entering the hive. The annotations will serve as ground truth for the validation of various automated animal tracking approaches.

License BSD-3 PyPI Python Version tests codecov napari hub


You can install napari-bee-annotator via pip:

pip install napari-bee-annotator

To install latest development version :

pip install git+

Getting started

  1. Open napari with the plugin and your video using the following command napari -w napari-bee-annotator --plugin video path/to/video.mp4. Note that you need to have napari_video installed to read mp4 files.

  2. Select the orientation of your video: horizontal/vertical refers to the direction of the bee's leaving/entering the hive.

  3. Start annotating: A simple left click indicates a bee moving up or to the left depending on the orientation selected. You can hold down the shift key to annotate a bee moving down or to the right. Annotations can be deleted with a right click on the annotation you want to delete. To move to the next frame, you can either hold down ctrl and scroll with the mouse wheel or click on the play button. Playback parameters, such as the playback speed, can be changed by right clicking on the play button.

  4. Saving and loading tracks: To save a tracks layer selected from the list of layers and click on File > Save selected layers. Choose a name and the csv extension. If you want to continue to work on the annotations for a specific video, you first have to load the corresponding csv file by clicking on Open with Plugin > Open file(s).... Select the file you want to load and click on open. A dialog should pop up that asks you to select the reader to use for loading the csv file. Select Bee annotator. Lastly, you have to tell the plugin to interact with the layer you just loaded by selecting it in the Tracks layer drop down menu.


Contributions are very welcome. Tests can be run with tox, please ensure the coverage at least stays the same before you submit a pull request.


Distributed under the terms of the BSD-3 license, "napari-bee-annotator" is free and open source software


If you encounter any problems, please file an issue along with a detailed description.


  • 0.0.1

Last updated:

  • 09 January 2024

First released:

  • 09 January 2024


Supported data:

  • Information not submitted

Open extension:

Save extension:

Save layers:

GitHub activity:

  • Stars: 1
  • Forks: 0
  • Issues + PRs: 0

Python versions supported:

Operating system:


  • numpy
  • magicgui
  • qtpy
  • scikit-image

Sign up to receive updates