Create Bingo cards with one command. One txt in, one A4-sized PDF out.

For running, it's recommended to use uv, an extremely fast Python package and project manager.

This work is marked CC0 1.0.

Usage

Usage: bingo.py [OPTIONS]

Options:
  --title TEXT         Card title text.  [required]
  --subtitle TEXT      Subtitle text.  [required]
  --instructions TEXT  Instruction line at the bottom.  [required]
  -o, --output FILE    Output file path.  [required]
  --help               Show this message and exit.

Example

If you're making a Bingo card for aliens coming to Earth, write this into tasks.txt:

Ride a roller coaster
Eat pizza
See the Northern Lights
Go to a concert
Visit the Grand Canyon
Learn to ride a bike
Watch a sunrise
Swim in the ocean
Try ice cream
Go camping
Visit a zoo
Watch a movie in a theater
VISIT EARTH
Go to a sports game
Visit a big city
See a waterfall
Have a picnic
Go hiking
Celebrate a holiday
Visit a museum
Go snowboarding
Eat tacos
See the Eiffel Tower
Make a human friend
Learn a human language

Then run a command:

uv run bingo.py \
  --title "To Do on Earth" \
  --subtitle "Experience the planet as a human" \
  --instructions "Complete a winning pattern (like a line, diagonal, or full card) by marking all the items on your card" \
  --output grid.pdf \
  < tasks.txt

Result: