https://github.com/apsalverda/warbler-songs-quiz-python
Small Python app to practice identifying birds by ear, using recordings from Cornell Lab of Ornithology's Macauley Library
https://github.com/apsalverda/warbler-songs-quiz-python
app birding birdsong cornell ebird library macauley merlin ornithology python quiz
Last synced: about 1 year ago
JSON representation
Small Python app to practice identifying birds by ear, using recordings from Cornell Lab of Ornithology's Macauley Library
- Host: GitHub
- URL: https://github.com/apsalverda/warbler-songs-quiz-python
- Owner: apsalverda
- Created: 2025-05-07T17:00:34.000Z (about 1 year ago)
- Default Branch: main
- Last Pushed: 2025-05-07T18:24:00.000Z (about 1 year ago)
- Last Synced: 2025-05-07T19:33:29.180Z (about 1 year ago)
- Topics: app, birding, birdsong, cornell, ebird, library, macauley, merlin, ornithology, python, quiz
- Language: Python
- Homepage:
- Size: 1.87 MB
- Stars: 0
- Watchers: 1
- Forks: 0
- Open Issues: 0
-
Metadata Files:
- Readme: README.md
Awesome Lists containing this project
README
# Birdsong Quiz
This app allows you to practice identifying birds by ear using recordings from [Cornell Lab of Ornithology's Macauley Library](https://www.macaulaylibrary.org).
### important requirements
You must own [a set of audio files](https://www.macaulaylibrary.org/product/the-cornell-guide-to-bird-sounds-us-and-canada/) purchased from Cornell Lab of Ornithology's Macauley library.
In the folder with the app, create a folder named "sounds". Copy all audio files (.mp3s) that you want to use for practice to this folder. **The app only works for these recordings**.\
### how the app works
The app creates a set of all recordings in the `/sounds` folder and plays a randomly selected recording.
If you want to hear the recording again, click `Repeat`.
Once you think you know which species you are listening to, click `Reveal` to show a picture of the species along with its name and additional information.
You can evaluate your response by clicking on an emoji, and the app will track your percentage correct score. (If you don't want to evaluate your current response, click `Skip`.)
If you indicate that your response is correct, the recording is removed from the set of recordings.
When no recordings are left, the app will start over by repopulating the set of recordings and give you the option to reset your score.
Audio files purchased from the Macauley Library contain metadata, including a picture, common name, Latin name, place of recording, and recording artist. The app pulls this information directly from the sound file and presents it on screen. The app therefore only needs the soundfile as input. You can easily make custom quizzes (e.g. Spring migration warblers in your area) by only including a relevant subset of soundfiles in the `sounds/` folder.
