Circagraph
Circagraph is a free, open-source timeline editor for exact dates at any scale, from deep time to fractions of a second, with sources on every event. Use it at circagraph.org, as a desktop app for Windows, macOS and Linux, as a single offline HTML file, or on your own server.
Open circagraph.org · Download · Try it offline · User guide · FAQ
What it does
- Any scale, exactly. A time is an arbitrary-precision fraction, never a rounded number. Place the Big Bang, a reign and a millisecond on one timeline, and zoom between them without losing a digit (time presentation).
- Sources on every event. Moments and durations carry notes, links, tags and relationships, and saved history keeps earlier versions (guide).
- Work together. Share publicly or privately, fork, and review changes as pull requests (collaboration). Compare up to eight timelines side by side (comparison).
- Large and live. Up to 200,000 events per timeline by default, and logs streamed in as they happen from syslog, journald or the HTTP API.
- Yours. GPLv3, with no account needed to edit. Timelines move between editions, and off any server, as
.ochx(JSON) or.och(SQLite) files.
Get started
| You want to… | Do this |
|---|---|
| Read or make timelines | Use circagraph.org. Browsing and local editing need no account. |
| Work offline | Download the desktop app (Windows, macOS, Linux) or the single offline HTML file. |
| Run your own server | sudo apt install ./openchronology-server-debian13-amd64.deb, or Docker, Nix, Homebrew, Windows and more: see installing a server. |
| Build it or change it | npm ci && npm run dev, then see building and testing and contributing. |
| Automate it | Use the HTTP API with an API key (administration). |
Every server also serves this documentation at /help, searchable and matching the version it runs. The technical disclosures describe its original mechanisms in enough detail to implement them, as a dated public record.