https://github.com/alanorth/safari-bingo-cards

Generate random wildlife bingo cards for safaris with data from Wikipedia
https://github.com/alanorth/safari-bingo-cards

africa pyvips safari vips wildlife

Last synced: 12 days ago
JSON representation

Generate random wildlife bingo cards for safaris with data from Wikipedia

• Host: GitHub
• URL: https://github.com/alanorth/safari-bingo-cards
• Owner: alanorth
• License: gpl-3.0
• Created: 2024-02-26T05:17:56.000Z (12 months ago)
• Default Branch: main
• Last Pushed: 2025-01-04T12:41:11.000Z (about 2 months ago)
• Last Synced: 2025-02-06T11:16:32.322Z (15 days ago)
• Topics: africa, pyvips, safari, vips, wildlife
• Language: Python
• Homepage:
• Size: 2.21 MB
• Stars: 0
• Watchers: 2
• Forks: 0
• Open Issues: 0
• Metadata Files:
  • Readme: README.md
  • License: LICENSE

Awesome Lists containing this project

README

        
# 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:

```console

$ ./generate.py -i data/animals.csv -o out.jpg

[INFO] Generated random sample of 32 animals...

[INFO] > Creating thumbnail for Helmeted guineafowl...

[INFO] Generated card with a 4x4 grid of animals...

[INFO] Wrote out.jpg

```

The script will download the images from Wikipedia, generate thumbnails for the sampled animals, and output a bingo card as a JPEG file.

# Requirements

Set up a Python 3.10+ virtual environment and install the requirements:

```console

$ python3 -m .venv

$ source .venv/bin/activate

$ pip install -r requirements.txt

```

# 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](https://www.gnu.org/licenses/gpl-3.0.en.html).

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](https://tldrlegal.com/license/gnu-general-public-license-v3-(gpl-3)).