Skip to content

Repository files navigation

festers

A small personal scheduler for The Black Lights festival (Blackpool, 26-28 June 2026): a music/film/art festival with many overlapping, repeated events across ~15 venues.

You tell it which events you want to see. It builds an attendance plan that:

  • minimises conflict (you cannot be in two places at once),
  • minimises travel (venue-to-venue movement and missed opening windows),
  • minimises misses (wanted events that do not fit),
  • and surfaces the choices you have to make (where two wants collide, or a repeated event lets you pick a different instance).

Designed to run on our Oracle Cloud server.

Status

Scaffold + first data capture. Today is 2026-06-24; the festival is this coming weekend, so this is time-boxed.

  • Festival schedule transcribed from the source PDF into data/schedule.json (104 events, 15 venues) - unverified, see loop-01.
  • Verify the transcription against the source.
  • Define the optimisation model and pick / reject a stack.
  • Build the picker + optimiser.

The stack is deliberately undecided (see docs/design.md).

Layout

data/festivals/<id>/schedule.json   per-festival data (the source of truth)
docs/      problem statement, data model, venue + travel notes
ooda/      OODA loops; each loop is a folder with a README (outcomes + tests)

festers now serves multiple festivals: the landing page lists them and each is browsed under /f/<id>/. A festival is self-contained data (its venues, travel matrix and events) — adding one is dropping a new data/festivals/<id>/schedule.json.

Source data

The festival timetable is published only as an image-only PDF (TBL-MAP-WEBSITE-001-02.pdf). It has been transcribed by hand into data/schedule.json. Times are stored as UTC instants (start_utc/end_utc, canonical per house rule) plus the local wall-clock (start_local) for humans. During the festival Blackpool is on BST (UTC+01:00).

A faithful human-readable transcript of the three day-schedules lives in docs/schedule-source.md, and the venue legend in docs/venues.md.

About

Travel-aware attendance planner for The Black Lights festival (Blackpool 2026): pick events, see conflicts, get an optimised plan.

Resources

Contributing

Stars

0 stars

Watchers

0 watching

Forks

Releases

Packages

Contributors

Languages