Current release: v1.42  ·  April 2026

Download Yearbirder

Free and open-source. Available as a one-click install on macOS,
or run from source on Windows and Linux.

Download for macOS

Signed & notarized  ·  macOS 12+

One file, drag-and-drop install

The macOS app is signed and notarized by Apple. No Python installation or terminal commands required.

Installation steps

1

Download Yearbirder

Click the Download for macOS button above. Your browser will download Yearbirder_v1.42.dmg.

2

Open the disk image

Double-click the downloaded .dmg file. A window will appear showing the Yearbirder app and your Applications folder.

3

Drag to Applications

Drag the Yearbirder icon into the Applications folder. That's the installation complete.

4

Open Yearbirder

Launch Yearbirder from your Applications folder or from Launchpad. The first time you open it, macOS may ask you to confirm — click Open.

5

Open your eBird data

Go to ebird.org/downloadMyData, click Request My Observations, and wait for the email with your download link. Once you have the .zip file, use File → Open in Yearbirder to load it.

Download Yearbirder

Requires Python 3.10+

Running from Python source

On Windows, Yearbirder runs from its Python source code. This takes about ten minutes to set up and only needs to be done once. The steps below are written for non-technical users — just follow them in order and you'll be up and running.

Setup instructions (one time only)

1

Install Python

Go to python.org/downloads and download the latest Python installer for Windows. Run it.

Important: On the first screen of the installer, check the box that says "Add Python to PATH" before clicking Install. If you miss this, Python won't work from the command line.
2

Open Command Prompt

Press the Windows key, type cmd, and press Enter. A black window will appear — this is the Command Prompt.

3

Install required packages

In the Command Prompt window, copy and paste the line below, then press Enter. This downloads the libraries Yearbirder needs. It may take a few minutes.

pip install pyside6 folium matplotlib numpy natsort piexif
4

Download Yearbirder

Click the Download Yearbirder button above. Your browser will download a zip file. Once it has finished, open the zip and move the yearbirder-1.42 folder to a convenient location, such as your Documents folder.

5

Navigate to the Yearbirder folder

Back in Command Prompt, type cd followed by a space and the path to the folder you unzipped. For example:

cd C:\Users\YourName\Documents\yearbirder-1.42

Tip: you can drag the folder from File Explorer into the Command Prompt window to paste its path automatically.

6

Run Yearbirder

Type the following and press Enter:

python yearbirder.py

Yearbirder will open. In future, repeat steps 5 and 6 to launch the app.

7

Open your eBird data

Go to ebird.org/downloadMyData, click Request My Observations, and wait for the email with your download link. Once you have the .zip file, use File → Open in Yearbirder to load it.

Python package requirements

These are installed in step 3 above. Listed here for reference.

PySide6Qt 6 GUI framework (LGPL)
foliumInteractive map rendering
matplotlibCharts and graphs
numpyNumerical data processing
natsortNatural-order sorting
piexifPhoto EXIF data reading
Download Yearbirder

Requires Python 3.10+

Running from Python source

Yearbirder runs from Python source on Linux. Python 3.10 or later is required. Most modern Linux distributions include a suitable Python; check with python3 --version.

Setup instructions

1

Confirm Python version

Open a terminal and run:

python3 --version

You need 3.10 or higher. If not, install it via your distribution's package manager (e.g. sudo apt install python3 on Debian/Ubuntu).

2

Install pip if needed

Many distros package pip separately. If pip3 --version fails, install it:

sudo apt install python3-pip # Debian / Ubuntu sudo dnf install python3-pip # Fedora
3

Install required packages

pip3 install pyside6 folium matplotlib numpy natsort piexif
Note: PySide6 on Linux requires certain system libraries. If the app fails to start with an error about libxcb, install the Qt platform dependencies for your distro. On Debian/Ubuntu: sudo apt install libxcb-cursor0
4

Download Yearbirder

Click the Download Yearbirder button above and unzip the downloaded file. Or, if you prefer to use git:

git clone https://github.com/trinkner/yearbirder.git
5

Run Yearbirder

cd yearbirder python3 yearbirder.py
6

Open your eBird data

Go to ebird.org/downloadMyData, click Request My Observations, and wait for the email with your download link. Once you have the .zip file, use File → Open in Yearbirder to load it.

Python package requirements

These are installed in step 3 above. Listed here for reference.

PySide6Qt 6 GUI framework (LGPL)
foliumInteractive map rendering
matplotlibCharts and graphs
numpyNumerical data processing
natsortNatural-order sorting
piexifPhoto EXIF data reading

Questions or problems?

The Yearbirder project is hosted on GitHub, where you can report a bug or browse the source code. To report a bug, click here.