mirror of
https://github.com/alanorth/safari-bingo-cards.git
synced 2024-12-25 06:34:30 +01:00
Generate random wildlife bingo cards for safaris with data from Wikipedia.
Alan Orth
00ab133921
I saw some advice once that we should log after the action completes instead of before. Let's at least be consistent. |
||
|---|---|---|
| data | ||
| .gitignore | ||
| example.jpg | ||
| generate.py | ||
| README.md | ||
Safari Bingo Cards
Fun proof of concept to generate random wildlife bingo cards for safaris with data from Wikipedia.
Usage
Once the requirements are satisfied you can generate a card. By default it generates a 4x4 grid with 16 images:
$ ./generate.py -i data/animals.csv -o out.jpg
Requirements
Set up a Python 3.11+ virtual environment and install the requirements:
$ python3 -m .venv
$ source .venv/bin/activate
$ pip install -r requirements.lock
TODO
- Credit photographers — these photos are all some variation of CC-BY so we need to give attribution
- Add filtering by region — the metadata already exists, though perhaps needs to be adjusted
- Refactor — perhaps needs to be more object oriented
- Make a web frontend — I can imagine a light frontend that would shuffle the images in realtime and allow generation of a number of cards
License
This work is licensed under the GPLv3.
The license allows you to use and modify the work for personal and commercial purposes, but if you distribute the work you must provide users with a means to access the source code for the version you are distributing. Read more about the GPLv3 at TL;DR Legal.