Case study

Judo Kata Tournament Manager

A browser-based competition system that runs an entire judo kata event from one laptop on the venue LAN: no internet, no spreadsheet, no licence fee. Free, open-source software (AGPL-3.0).

The problem

Kata competitions are scored by a panel of judges across multiple rulesets. That work was being done on paper and in spreadsheets: judges scored on sheets, a clerk tallied by hand, results were re-entered, and the hall had nothing live to watch. Slow, error-prone, and disconnected from what the audience saw.

The existing alternatives fell short:

  • Excel scoresheets: single-user files: no live devices, no hall display, totals entered manually.
  • Paper scoresheets: manual tallying and re-entry; hard to correct or audit mid-event.
  • Generic tournament software: targets shiai (contest) brackets, not kata panels and rulesets.
  • Cloud tools: depend on venue internet, which is often unreliable or absent.

The cost was hours of manual entry, risk of incorrect official results, disputes, delayed results, and stressed volunteers.

The solution

One laptop acts as the server on the venue's local network; every other screen (judge tablets, clerk workstation, announcer board, hall displays) is a plain browser on the same LAN. One SQLite file per event: the organiser owns the data. No account, no cloud, no internet connection required.

What it does

  • Draw and seeding, with prelim-to-final formats and nationality policy checks
  • Named judge tablets: S/M/B/F marks, ± corrections, submit/unsubmit, shadow seats
  • Three scoring rulesets: EJU, kata-judge/BJA-style and IJF
  • Live hall results, announcer board, and animated draw and award ceremonies
  • Printable PDF score packs: cover, order, results, and pair×judge sheets
  • CSV exports and a scoring audit log of every tap, submit, and unsubmit
  • Browser scoresheet fallback for judge tablet failures, plus replacement warnings
  • Live screens in English, French, and German

How it was built

  • Perl web application, dependencies locked by cpanfile; decisions documented in ADRs; CI runs the test suite
  • Browser front end: judge devices need no installs
  • SQLite file per event: the whole competition in one place the organiser keeps
  • Offline-first: the venue LAN is the network
  • Audit log of every tap, submit and unsubmit; CSV export and PDF score packs

Validation

Tested and run against a real international competition: the 2024 Silesian Open Judo Kata Competition, including the senior categories. Multiple mats, rotation, tight schedules, official results under scrutiny: the kind of event where a system gets found out. It has since been used across multiple club and national kata events.

Onboarding is via demo and supervised test events, because the self-hosted setup needs someone to configure the server correctly for the venue.

Where it fits

Best for

Clubs, federations, and organisers running kata competitions who want tablets, live results, and reliable offline operation.

Not ideal for

Events needing cloud or multi-site access, online public entry and payment, or shiai (non-kata) bracket management.

Want software like this?

Free, open-source software, with commercial support behind it. If you have a process that still runs on paper and spreadsheets, that is exactly what I build. Email me your event date, kata and rough pair count.

Talk about your project