Status: early draft. Nothing here is stable yet, and everything is open for discussion.
This repository holds the open protocol that lets indoor cycling apps share riders, so riders of different apps can meet on the same road. See the organisation profile for the overall goal.
spec/v0.md: the specification (messages, transport, versioning).routes/: shared route files with stable IDs, so that a position on a route means the same spot in every app. A route may also come as a GPX track (routes/<id>.gpx) for apps that only ride GPS routes; the JSON file stays the authority.tools/velodrome_gpx.pywrites the velodrome's track.schemas/: JSON Schemas for routes and messages.examples/: example messages, used as shared test data.apps.md: optional list of apps that speak the protocol.
Run python3 tools/validate.py to check routes, GPX tracks, schemas and examples.
The reference server lives in OpenBikeNet/server. A
public instance runs at openbikenet.cloud: apps connect to
wss://openbikenet.cloud/v0. Anyone can run their own server; apps choose which one to use.
- Shared presence: apps report their riders' positions on shared routes and see the riders of other apps. Each app keeps its own physics.
- Shared physics (later): apps send power and cadence, and the server calculates speed with one common model, so fair races become possible.
If you build an indoor cycling app and want your riders to meet riders of other apps, join the conversation in Discussions. Ideas, needs and objections are all welcome, especially from developers who already run multiplayer.
Both are permissive, so any app can implement the protocol, open source or not.