Open Chronology Files

The first tagged release of OpenChronology: an editor for timelines whose times are exact rational numbers, as a website you can host, a desktop app and a single offline HTML file.

Early release. This version hasn't run in production yet. In SemVer terms, anything may change before 1.0, including file formats, the HTTP API and settings, though changes to .ochx and .och files will come with conversions. The hosted-service terms and privacy notice are drafts. Please report what breaks.

What's in it

• Events on an exact time axis. An event is a moment (one time) or a duration (a span, whose ends can follow moments). A third of a second stays exactly a third at any zoom. Nearby events gather into summaries and separate as you zoom.
• Time display:
• exact rationals, decimals, scientific and SI units, Gregorian dates and custom printers;
• rulers that graduate by calendar or decimal steps.
• Organising: tags, links between events, search, separation by tags or by links, and comparing timelines on one axis.
• Plugins and suites: icons, colours, shapes, stacks, backgrounds, rich notes and headings. The Causal factor analysis and History education suites bundle these for common uses.
• Server (platform):
• accounts, private and public timelines, sharing and embedding;
• forks, pull requests, history and retention;
• moderation, syslog and log import;
• an HTTP API with an OpenAPI reference;
• help at /help.
• Desktop app: native .och (SQLite) files, with large timelines kept in an indexed native store, and connections to one or more servers.
• Offline file: the whole editor in one HTML file that never uses the network. The CFAM edition starts with the causal factor analysis plugins, Gregorian dates and today in view.

Downloads

The assets below are built from this tag by the release workflow. SHA256SUMS.txt lists their checksums.

• Desktop:
• Windows (.exe installer);
• macOS, Apple silicon and Intel (.dmg);
• Linux: .deb, .AppImage, and .rpm for Rocky Linux and RHEL 10.
• Server packages:
• Linux: Debian 13 and Ubuntu 24.04 (.deb), Fedora 44 and Rocky Linux 10 (.rpm);
• FreeBSD 14 and 15 (.pkg);
• macOS (Homebrew: brew install openchronology/tap/openchronology-server);
• Windows;
• Docker Compose from the source.
• The package installs set up PostgreSQL with pgmp.
• Offline browser files: openchronology-offline.html, and the CFAM edition openchronology-offline-cfam.html (also at https://openchronology.github.io/ and https://openchronology.github.io/cfam/).
• Source: the web and desktop source archives that match these builds.

See the README to run or build it, and administration to run a server.

OpenChronology is free software under the GNU GPL version 3. It comes with no warranty.