Installation

Birdwatcher officially supports Python 3.12 or higher, but older Python 3 versions may also work.

User installation

1. We recommend using Anaconda for installation. Install Anaconda from https://www.anaconda.com/ .

2. Open Anaconda prompt in terminal.

3. Create new environment for Birdwatcher (name is up to you, in example here ‘mybirdwatcher’). We install Jupyter lab and ffmpeg at the same time:

   conda create -n mybirdwatcher python=3.14 git=2.51 ffmpeg=8.0.1 numpy=2.4.2 matplotlib=3.10.8 pandas=3.0.0 seaborn=0.13.2
   

4. Switch to this new environment:

   conda activate mybirdwatcher
   

5. Install jupyter from conda-forge (currently conda one has a problem):

   conda install -c conda-forge jupyter
   

6. Install Birdwatcher:

   Stable latest official release from PyPi:

   pip install Birdwatcher
   

   If instead you want the latest version of the git main branch from, use:

   pip install git+https://github.com/gbeckers/birdwatcher@main
   

Dependencies

The following dependencies are automatically taken care of when you install Birdwatcher using the pip method above:

• numpy

• pandas

• matplotlib

• seaborn

• darr

• opencv-python

• opencv-contrib-python

It further depends on:

• ffmpeg (including ffprobe)

If you do not use the conda way above to install ffmpeg, you need to install it yourself (https://www.ffmpeg.org/).