Current release: v2.20  ·  October 2026

Download Yearbirder

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

Download for macOS

Signed & notarized  ·  macOS 13+  ·  Apple Silicon

One file, drag-and-drop install

  • Signed and notarized by Apple for your security.
  • Apple Silicon Macs only. Yearbirder runs on Apple M-series chips (M1 and later, sold from late 2020 onward). It does not run on older Intel Macs.
  • To check your processor type, choose Apple menu → About This Mac. If Chip reads "Apple M1", "Apple M2" or similar, your Mac will run Yearbirder.

Installation steps

1

Download Yearbirder

Click the Download for macOS button above. Your browser will download Yearbirder_v2.20.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.

Two ways to install

  • The Microsoft Store — Fully signed, authenticated by Microsoft, installs without security warnings and automatically updates with each version.
  • Setup.exe file — Bypasses the Store, but you will need to click through two security prompts and update it manually.

Optimized for x64 processors — the Intel and AMD chips in most Windows PCs. On ARM-based Windows PCs (Snapdragon and Copilot+ machines), a few HTML-based features may scroll slowly.

Already have Yearbirder from the installer? Uninstall it before installing from the Store. The two are separate installations and will otherwise sit side by side — two entries in your Start Menu, each updating by its own route. Your eBird data, media catalog, photos and recordings are untouched either way, but the Store copy starts with fresh settings, so you will need to re-open your catalog and re-enter your optional eBird API key.
Windows security prompts — direct installer only — These two dialogs appear when you run the .exe. They do not appear if you install from the Microsoft Store, which Microsoft signs. Both are normal for free, independent apps that are not commercially code-signed. Yearbirder is safe and open-source; its full source code is on GitHub.

1. SmartScreen — A blue screen saying "Windows protected your PC." Click More info, then Run anyway.

2. User Account Control — A prompt asking "Do you want to allow this app from an unknown publisher to make changes to your device?" Click Yes to allow the installer to place Yearbirder in Program Files.

Installing with the direct installer

Installing from the Microsoft Store needs no instructions — open the Store listing and click Get. These steps are for the .exe.

1

Download the installer

Click Download the installer above. Your browser will download Yearbirder_Setup_v2.20.exe.

2

Run the installer

Double-click Yearbirder_Setup_v2.20.exe. If Windows shows a SmartScreen warning, click More info and then Run anyway. Follow the installer prompts — the defaults are fine.

3

Launch Yearbirder

Open Yearbirder from the Start Menu. You can also optionally create a desktop shortcut during installation.

4

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

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 soundfile soxr

soundfile and soxr are what read and resample your recordings — without them the Recordings features will not work. Two further packages are optional: mutagen lets Yearbirder read the date out of ID3-tagged audio, and certifi supplies its own set of HTTPS certificates. Yearbirder works without either, falling back to the filename for dates and to your system's certificates.

System libraries: the Python packages above do not bring everything Qt needs on Linux.

If the app will not start with an error mentioning libxcb, install the Qt platform dependencies. On Debian/Ubuntu: sudo apt install libxcb-cursor0

If recordings will not play, Qt's audio support on Linux is built on GStreamer, which is not included in the Python packages. On Debian/Ubuntu: sudo apt install libgstreamer1.0-0 gstreamer1.0-plugins-base gstreamer1.0-plugins-good

If maps and reports are blank, those are rendered by Qt WebEngine, which needs NSS. On Debian/Ubuntu: sudo apt install libnss3
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.