Skip to content

Releases

v0.29.0

Choose a tag to compare

@github-actions github-actions released this 12 Nov 18:00
0177bc3

Changes since v0.28.0.

Early release. 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.

Added

  • Show: hide parts of the timeline (#618). Show in the toolbar (in Tools on a phone) opens a switch for each part of the timeline (moments, durations, backgrounds, relationships and the balances at the edges) and for each chart it draws, with the chart's color and the plugin that draws it. Chart plugins appear there without any changes. Hiding changes only what that browser tab shows, never the timeline, and the button counts what is hidden.
  • One chart axis at a time (#617). Every chart is still drawn, but only one measure's axis shows. With several charts, a picker above them chooses whose axis it is, and the other charts' lines fade behind it.

Upgrading

Install the new package and run openchronology-migrate as usual. There are no database changes.

v0.28.0

Choose a tag to compare

@github-actions github-actions released this 12 Nov 15:41
eac2733

Changes since v0.27.0.

Early release. 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.

Added

  • A chart for every measure, in its own color and on its own axis (#614). A timeline's measures are each charted without a plugin, so their relative values can be read side by side.
    • Measures dialog: each measure has a Chart setting (its balance, its rate per time, or off) and a Chart color. Unchosen colors come from a fixed palette.
    • Crowded charts: with more than two charts, fills are dropped and only the lines are drawn.
  • Measure charts in separations (#616). Each separated track draws its own measure charts in its own row, from the moments and durations it holds. The tracks' balances add up to the whole timeline's.
  • Chart axes above the moments, with a readout under the mouse (#612). Axes have more values, and hovering a chart shows its balance and the time at the mouse.

Fixed

  • Resizing items with Ctrl and the mouse wheel no longer changes the chart axes (#612).
  • Shaped markers over backgrounds no longer have a round ring around them (#613).

Upgrading

Install the new package and run openchronology-migrate as usual. There are no database changes.

v0.27.0

Choose a tag to compare

@github-actions github-actions released this 12 Nov 01:35
f28b6f4

Changes since v0.26.0.

Early release. 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.

Added

  • Several measure charts, each with a value axis (#610). Every enabled measure and balance chart is drawn, over the moments chart and each on its own scale and in its plugin's color. Before, only the last enabled chart plugin's chart showed.
    • Axes: each chart has an axis on the timeline's right edge: its measure's label, and round values in the measure's format, abbreviated ($1T, $2T, $3T).
    • Balance charts: the axis runs from the view's lowest balance to its highest.
    • Measure charts: the curve is now a rate, and its axis says what it's per: the time axis's step, such as Spending per 10 years.

Fixed

  • Balance charts and readouts on server and desktop timelines (#609).
    • Merged summaries: merging summaries that drew too close dropped their balance. The balance chart then stayed level until the view's edge and jumped to the closing balance.
    • Opening balances: the readouts in the lower corners showed the balance at the edges of the window fetched around the view, not the view's own edges. The opening balance could be decades early.

Changed

  • Builds: CI builds the Linux server and desktop packages from prebuilt images, so a distribution mirror's outage no longer fails a release (#605, #606, #608). The Apple silicon desktop app is built on the project's own Mac (#607).

Upgrading

Install the new package and run openchronology-migrate as usual. There are no database changes.

v0.26.0

Choose a tag to compare

@github-actions github-actions released this 11 Nov 17:18
1e757fc

Changes since v0.25.0.

Early release. 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.

Added

  • Measures (#570). A timeline declares named, exact quantities, such as a cost or hours worked, and its moments and durations carry values for them.
    • Exact values: integers and rationals, never floating point. They are validated in the browser, on servers and in desktop files (#577, #589).
    • Official formats: each type has formats from one official library, such as currency (#590).
    • Totals: every summary of a window totals its measures, in the browser, on servers and in desktop files (#579, #581). A duration counts where it starts (#583).
    • Comparisons: each timeline keeps its own totals, which are never added across timelines (#591).
    • Plugins: scripts and derived metadata read a summary's totals (#592).
  • Running balances (#595). A measure can have an opening or closing balance, or a balance at a time. Its durations' values apply at their start or end.
    • Where they are kept: balances are indexed on servers and in desktop files (#596, #597, #598).
    • In the editor: the Measures dialog sets them, and the view's corners show the balance before and after it. Summaries, the reader and hover cards show balances as before → after (#602).
    • For plugins: a balance chart kind draws the running balance as a step line, and api.balance(name) reads it exactly (#602).
  • Boards and plans as sources of work (#568, #569). Trello boards, Jira projects, Planner plans and OpenProject projects are mirrored into timelines alongside repositories. Forge due dates, roadmaps and Microsoft Project files are planned as a Gantt chart.
  • Update notices (#601).
    • Desktop app: it tells you of a newer release, checking at most once a day.
    • Servers: signed-in administrators see a banner, and each administrator's dismissal is kept until the next release. UPDATE_NOTICES=off turns it off.
  • A download page that asks which system you run (#599). It gives steps for Windows, macOS and Linux distributions, including Arch through the AUR, for the desktop app and the server.

Fixed

  • Saves keep every setting (#584). Changing the time display, or following a save, no longer drops the image, the default view or the measures.
  • A zoom's first frame moves the view on a busy page too (#594).

Upgrading

Install the new package and run openchronology-migrate as usual. The migration adds the measure and balance indexes and the administrators' update-notice column. It rebuilds the indexes of timelines that already declare measures, and no others.

v0.25.0

Choose a tag to compare

@github-actions github-actions released this 10 Nov 16:00
14e4097

Changes since v0.24.2.

Early release. 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.

Added

  • <och-timeline>: a timeline in any page or AI chat reply (#566). The new npm package @openchronology/timeline is the offline editor as one element, loaded from jsDelivr or unpkg:
    <script src="https://cdn.jsdelivr.net/npm/@openchronology/timeline@0.25.0/dist/timeline.js"></script>
    <och-timeline mode="view" height="480">
      <script type="application/json">{ "title": "Moon landings", "presentation": "gregorian", "events": [ … ] }</script>
    </och-timeline>
    • What it shows: the timeline written inside it, opened at its default view, for editing or in View mode, with Export to take it away as .ochx.
    • Less to write: it fills in the format, version and description, and "presentation": "gregorian" stands for the Gregorian time display.
    • Safe to drop in: it runs in a sandboxed frame of its own with no network requests, so the page and the timeline can't reach each other.
    • Where it works: web pages, documentation sites, and the artifacts and HTML previews of AI chats. /llms.txt points models to it (docs).
  • The offline file opens a timeline written into its page (#566), in a compact layout without its header; this is what the element uses.

Upgrading

Install the new package and run openchronology-migrate as usual. There is no migration.

v0.24.2

Choose a tag to compare

@github-actions github-actions released this 10 Nov 06:35
d8d779c

Changes since v0.24.1.

Early release. 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.

Changed

  • Separated server timelines load faster (#564). A separation's tracks were each read in a request of their own, one after another, and every separated track carried the whole timeline's relationship arcs again. They are now read together in one request (kind: "tracks" on the timeline query endpoint), with the arcs once, each end naming the track it is on. A view with seven separations went from eight requests per window to one.
  • Lighter windows (#565). A server's windows no longer carry each duration's notes preview, which was most of their size, unless an enabled plugin shows notes on the timeline (such as Focus on hover). Opening a duration, also on a compared or separated track, reads it whole. On a mirrored repository's timeline, a window of its issues and pull requests went from 228 KB to 80 KB.

Upgrading

Install the new package and run openchronology-migrate as usual. There are no database changes.

v0.24.1

Choose a tag to compare

@athanclark athanclark released this 10 Nov 01:04
3add4aa

Changes since v0.24.0.

Early release. 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.

Changed

  • The bar above separated tracks is one line (#563). It names what is shown ("7 separations", or the view's title) with a Default view badge and its buttons. Each separation's tags, disjoins and unions are in the Separate dialog rather than listed in the bar, which on a phone took most of the screen.
  • "Separate by tags" is now "Separate" (#563), since it also holds separations by relationships.
  • Loading a window shows a small spinner in the timeline's corner (#563), instead of a "Loading this window…" notice.

Fixed

  • Tags with commas (#562). Events saved through the API could keep a tag with a comma, such as sovereign, banking and currency crisis, while separations and views refused it. A comma inside a tag now becomes a semicolon everywhere tags are saved. Tags saved before are read the same way, so separations select them without any change to stored timelines.

Upgrading

Install the new package and run openchronology-migrate as usual. There are no database changes.

v0.24.0

Choose a tag to compare

@athanclark athanclark released this 09 Nov 19:08
b498bfc

Changes since v0.23.2.

Early release. 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.

Added

  • Ongoing durations (#537, #539–#541). A duration's end can be Ongoing (until now): it is drawn up to the present and keeps growing. Only timelines with the Gregorian time display have a "now". Servers store and resolve them at their clock, and desktop files hold them too.
  • Mirroring work from forges (#538, #542–#547). och-import-github and a webhook receiver mirror a repository into a timeline, read-only:
    • Issues and pull requests (merge requests on GitLab) are durations, ongoing while open. What happens to them (assignments, labels, reviews, mentions, closing, merging) is moments, and "closes #12" is a link.
    • Also mirrored: releases, milestones, time in each board column, commits, branches and forks.
    • Platforms: GitHub (and GitHub Enterprise), Forgejo, Gitea and GitLab, one repository per timeline.
    • Packages: every server package ships the receiver (openchronology-github, installed stopped until configured) and och-import-github (docs).
  • A Branches view for mirrored repositories (#557). The importer saves a view of the seven most recently active branches, each in a track from when it began until it was merged. It becomes the timeline's default view unless the timeline already has one; --no-branch-view turns it off.
  • Several separations at once (#548). Separate by tags keeps a list of separations, each a track, with a searchable tag picker.
  • Disjoins and unions (#549). A separation can disjoin from the main timeline (or another separation) and unite back into one, each at an exact time, at a moment, or at the earliest or latest of its moments. Each is a card in the separation's list, edited in a dialog of its own.
  • Saved views (#550, #551). A view is a named set of separations of a timeline:
    • Visibility: private or public, and shared with viewers and editors.
    • Copies: forked or duplicated like timelines, or reassigned to another timeline as a template.
    • Default view: a timeline's authors can make one its default, which follows the view as it changes.
    • API: API keys and AI assistants can make views through /api/views (docs).
    • Files: desktop files and .ochx exports keep a list of views of their own.
  • Separating by relationships beside tags (#552). An event's Separate related and Separate all connected add a track beside the separations by tags, with disjoins and unions of its own.

Changed

  • Separated tracks are drawn at your text size (#556). The stage grows to show them, up to the window's height, and pans for the rest.
  • Tracks follow what is in view (#560). A separation with nothing in view is not drawn. One that disjoins and unites again within less than the grouping distance is a summary on the track it unites into, opening out as you zoom in.
  • Event tags may be up to 128 characters (#545); a timeline's own tags stay within 64.

Fixed

  • Text cut short inside an emoji (#554). A duration whose notes had an emoji at the 2,000th character could not be saved. Text is now always cut between whole characters.
  • Ongoing durations (#555):
    • they are drawn to now on server timelines and on separated tracks, not as points at their starts;
    • Related to lists them ending now.
  • Opening a duration and separating its relationships no longer records an edit nobody made (#555).

Upgrading

Install the new package and run openchronology-migrate as usual. The migration adds the saved views' tables (oc_saved_views, oc_saved_view_members).

To mirror a repository, configure github.env and enable openchronology-github (docs). It stays stopped until then.

v0.23.2

Choose a tag to compare

@athanclark athanclark released this 07 Nov 18:31
41d9f7f

Changes since v0.23.1.

Early release. 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.

Fixed

  • Continue with Google or GitHub failed from the sign-in page with "Invalid sign-in return location" when it was to return to Explore or a timeline's page (#536). The sign-in page and the server now check one list of pages to return to.

Changed

  • The terms of service and privacy policy take effect on 7 November 2026 (#535). The privacy policy describes what desktop sign-in now records: the computer's name and system, and whether it asked from the approving browser's network. Every account is asked to agree again before changing anything.
  • GitHub Actions updated by Dependabot (#534).

Upgrading

Install the new package and run openchronology-migrate as usual. The migration updates the policy version the database checks.

v0.23.1

Choose a tag to compare

@athanclark athanclark released this 07 Nov 15:43
e6d1fb9

Changes since v0.23.0.

Early release. 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.

⚠ Before you upgrade

  • Docker Compose: add APP_DATABASE_PASSWORD to .env, different from POSTGRES_PASSWORD. Compose now runs the app as an ordinary database role, openchronology_app, and refuses to start without it.
  • NixOS: the syslog receiver and journald follower no longer read the server's environmentFile. Give them their API keys with the new services.openchronology.syslog.environmentFile and journald.environmentFile; the module warns while either is unset.
  • Packages (Debian, Ubuntu, RPM, Arch, FreeBSD): nothing to do. The upgrade creates the openchronology-logs user and moves the log receivers' settings to it.

Security

This release hardens every edition, following a security review. Advisories will be published once servers have upgraded.

  • Server:
    • Request bodies: routes anyone can call accept only small requests, and deeply nested JSON is refused before it is parsed.
    • Anonymous load: anonymous queries and tag-filtered views are rate-limited and queued.
    • Rate limits: an IPv6 client is counted by its /64.
    • Proof-of-work answers: they can't be reused.
    • Smaller fixes: in the LDAP filter and in embed titles.
  • Web pages:
    • Security headers: every page gets the content security policy, framing protection, nosniff, no-referrer and HSTS.
    • Google Analytics (when an operator enables it) is never sent private timelines' titles or addresses, or sign-in codes.
  • Desktop app:
    • Opening .och files: a crafted file can no longer crash the app or the server's converter.
    • File links: a timeline's links are followed only inside folders you chose, or in a timeline you trust, asked in the app's own dialog. Opening a file uses an allowlist of kinds, and other files are shown in their folder.
    • System thumbnailers run only on files you chose.
    • Images: a timeline opened from a file hides images from other sites until you choose to show them.
    • Permissions: the window can call only the app's own commands.
    • Private files: staged files and thumbnails are private to you.
  • Desktop sign-in: the approval page shows which computer is asking. A request from another network needs a second confirmation, which the server enforces.
  • Offline file and editor: the capacity notice keeps only hashes in browser storage, and survives bad values there.
  • Packaging:
    • Windows server: it takes ownership of its data folder and trusts nothing it didn't create.
    • Docker Compose and Homebrew: the app connects to the database without superuser rights.
    • Log receivers: the syslog receiver and journald follower run as their own user, openchronology-logs, and can't read the server's secrets.
    • systemd: more sandboxing.
    • Release assets: they carry build provenance attestations (gh attestation verify <file> --repo openchronology/timeline-app).
    • Pinning: Rust is fixed to one release, and base images are pinned by digest.

Added

  • Page caching: public pages seen signed out can be cached by a reverse proxy for a minute, with Vary: Cookie; anything signed in stays private. Administration has an nginx sample and how to measure page speed.
  • A comparison of timeline tools in the help, and an FAQ answer pointing to it.
  • New help pages: Installing a server and Building and testing, which take over the README's detail.

Changed

  • The README is short: what OpenChronology does, and where to go next.
  • The hosted offline copy at openchronology.github.io changes only with stable releases.
  • The NixOS module hides nginx's version.

Upgrading

Install the new package and run openchronology-migrate as usual. The migration adds two columns to desktop sign-in requests.