Skip to content

GPXSheet

Motorcycle sport-touring route awareness generator.

GPXSheet converts GPX routes into glanceable, map-centric motorcycle navigation aids optimized for tank-bag use. Route structure — which turns are real decisions versus mere curves, road names, and fuel — comes from OpenStreetMap rather than raw geometry, so the output reflects the road network instead of flooding twisty roads with false turns. See the design notes for the goals and the engineering behind it.

Three ways to use it:

  • CLI — gpxsheet generate route.gpx -o route.pdf (also table, analyze, strip, preview, validate).
  • Python library — see the Library API.
  • Web service — a FastAPI app exposing the engine over REST; see the Web API guide and the API reference.

Install

pip install gpxsheet              # library + CLI
pip install "gpxsheet[service]"   # + the web service
  • Library API — render, analyze, validate, and the route model.
  • Web API guide — the submit → poll → fetch job model, with browser fetch examples.
  • Web API reference — interactive OpenAPI for every endpoint.
  • Deployment — hosting and hardening for public exposure.
  • Design notes — the full product/engineering specification.