https://github.com/biigle/biigle4beginners
A beginner's tutorial for the BIIGLE image and video annotation tool.
https://github.com/biigle/biigle4beginners
image-annotation liascript-course open-educational-resources video-annotation
Last synced: about 2 months ago
JSON representation
A beginner's tutorial for the BIIGLE image and video annotation tool.
- Host: GitHub
- URL: https://github.com/biigle/biigle4beginners
- Owner: biigle
- License: cc-by-4.0
- Created: 2026-04-23T14:47:04.000Z (3 months ago)
- Default Branch: main
- Last Pushed: 2026-05-28T14:38:37.000Z (about 2 months ago)
- Last Synced: 2026-05-28T16:21:11.776Z (about 2 months ago)
- Topics: image-annotation, liascript-course, open-educational-resources, video-annotation
- Homepage: https://liascript.github.io/course/?https://raw.githubusercontent.com/biigle/biigle4beginners/refs/heads/main/tutorial.md
- Size: 36.8 MB
- Stars: 0
- Watchers: 0
- Forks: 0
- Open Issues: 0
-
Metadata Files:
- Readme: README.md
- License: LICENSE
Awesome Lists containing this project
README
# BIIGLE for Beginners
A tutorial for [BIIGLE](https://biigle.de), a web-based platform for annotating images and videos.
BIIGLE is a free and open-source platform for annotating images and videos from scientific surveys. Applications range from marine imagery by remotely operated vehicles, drop cameras, or autonomous underwater vehicles to terrestrial imagery and microscopy.
This tutorial teaches the complete beginner workflow: from creating a user account, through setting up projects and annotating data, to exporting the results. Each chapter introduces one concept, then gives you a hands-on task to solve on [biigle.de](https://biigle.de).
## Target audience
Anyone who is new to BIIGLE and wants to learn how to set up their own annotation projects and how to annotate.
## Required time
Completing the tutorial takes less than 2 hours (excluding waiting time, see below).
> [!IMPORTANT]
> New users and uploaded files on [biigle.de](https://biigle.de) must be approved by an admin. This usually takes no more than one business day. Please take the waiting time into account when you start the tutorial.
## View the tutorial
The tutorial is available as LiaScript course:
[](https://liascript.github.io/course/?https://raw.githubusercontent.com/biigle/biigle4beginners/refs/heads/main/tutorial.md)
## What you will learn in this course
- **Chapter 1**: [Introduction to BIIGLE](https://liascript.github.io/course/?https://raw.githubusercontent.com/biigle/biigle4beginners/refs/heads/main/tutorial.md#2)
- **Chapter 2**: [Signing up and the dashboard](https://liascript.github.io/course/?https://raw.githubusercontent.com/biigle/biigle4beginners/refs/heads/main/tutorial.md#6)
- **Chapter 3**: [Projects, volumes, users, and roles](https://liascript.github.io/course/?https://raw.githubusercontent.com/biigle/biigle4beginners/refs/heads/main/tutorial.md#9)
- **Chapter 4**: [Label trees (your annotation vocabulary)](https://liascript.github.io/course/?https://raw.githubusercontent.com/biigle/biigle4beginners/refs/heads/main/tutorial.md#14)
- **Chapter 5**: [Creating image and video volumes](https://liascript.github.io/course/?https://raw.githubusercontent.com/biigle/biigle4beginners/refs/heads/main/tutorial.md#20)
- **Chapter 6**: [Annotating images](https://liascript.github.io/course/?https://raw.githubusercontent.com/biigle/biigle4beginners/refs/heads/main/tutorial.md#28)
- **Chapter 7**: [Annotating videos](https://liascript.github.io/course/?https://raw.githubusercontent.com/biigle/biigle4beginners/refs/heads/main/tutorial.md#35)
- **Chapter 8**: [Exporting reports](https://liascript.github.io/course/?https://raw.githubusercontent.com/biigle/biigle4beginners/refs/heads/main/tutorial.md#40)
## Sample data
Sample images and a sample video are used in the hands-on tasks. Download links are provided inside the tutorial. You can also use your own data.
## Questions and feedback
If you have questions or feedback about this tutorial, please open a new [discussion](https://github.com/orgs/biigle/discussions).
## Authors
- **Martin Zurowietz** (https://orcid.org/0000-0002-7122-2343), Bielefeld Institute for Bioinformatics Infrastructure, Bielefeld University (https://ror.org/02hpadn98). Roles: Conceptualization, Visualization, Writing – original draft, Writing – review & editing
- **Juliane Röder** (https://orcid.org/0000-0002-4692-2700), Philipps University of Marburg (https://ror.org/01rdrb571). Role: Writing – review & editing
## License
[OBSEA images](https://doi.pangaea.de/10.1594/PANGAEA.946149): © 2022 by Marco Francescangeli *et al.* [CC BY 4.0](https://creativecommons.org/licenses/by/4.0/).
[WING IT video](https://video.blender.org/w/vrjS4NB4cwnJhrib8uEwi6): © 2023 by Blender Studio [CC BY 4.0](https://creativecommons.org/licenses/by/4.0/).
[Icons](https://fontawesome.com/): © 2026 by Fonticons, Inc. [CC BY 4.0](https://creativecommons.org/licenses/by/4.0/).
All other material (unless otherwise noted): © 2026 by Martin Zurowietz [CC BY 4.0](https://creativecommons.org/licenses/by/4.0/).
## How to cite
```
Martin Zurowietz, & Röder, J. (2026, May 28). biigle/biigle4beginners. Zenodo. https://doi.org/10.5281/zenodo.20505832
```
```bibtex
@misc{martin_zurowietz_2026_20505832,
author = {Martin Zurowietz and
Röder, Juliane},
title = {biigle/biigle4beginners},
month = may,
year = 2026,
publisher = {Zenodo},
doi = {10.5281/zenodo.20505832},
url = {https://doi.org/10.5281/zenodo.20505832},
}
```
## Funding and acknowledgment
The development of this tutorial was supported by the German Research Foundation (DFG) within the project “Establishment of the National Research Data Infrastructure (NFDI)” in the consortium NFDI4Biodiversity (project number 442032008).
Visit: