Skip to content

swingalytica/database

Repository files navigation

RealGolf.Games Database

Monthly data dumps of public games from RealGolf.Games, published in GGN format.

Downloads

Dumps are published at database.realgolf.games on the first of every month.

Each file contains only the public games created in that specific month, one serialized GGN string per line, compressed with gzip.

Dumps are not cumulative. To reconstruct the full public dataset, download every monthly file.

YYYY-MM.ggn.gz

Format

Games are stored in GGN (Golf Game Notation) — an open format inspired by PGN. See the GGN Specification for full documentation.

Parsing

Use the official CLI to work with GGN files:

pnpm add -g swingalytica
swingalytica ggn -i 2026-07.ggn

License

  • Code (export scripts, website) — MIT
  • Data (.ggn.gz dump files) — CC BY 4.0

When using the data, attribution is required:

Data provided by RealGolf.Games, licensed under CC BY 4.0.

Website configuration

The Astro site fetches the dump listing directly from Supabase Storage using public environment variables:

PUBLIC_SUPABASE_URL=...
PUBLIC_SUPABASE_ANON_KEY=...

Monthly export workflow

.github/workflows/dump.yml runs on the first day of every month and:

  • reads the previous month's public games from MongoDB
  • exports them to YYYY-MM.ggn
  • compresses the dump to YYYY-MM.ggn.gz
  • uploads the gzip file to the public dumps bucket in Supabase Storage

Links

About

Export of all games ever played on RealGolf.Games

Resources

License

MIT, CC-BY-4.0 licenses found

Licenses found

MIT
LICENSE
CC-BY-4.0
LICENSE-DATA

Stars

0 stars

Watchers

0 watching

Forks

Releases

No releases published

Packages

 
 
 

Contributors