circagraph
Sign inSign up

Help

New here? Start with using Circagraph, or look for your question among the frequently asked questions. Every topic below is also searchable.

Take the tour of the editor

Start here

Making timelines

Timeline time presentationHow a timeline shows its times: calendar dates, numbers, units or your own format, with exact times underneath and dates before year 1.DurationsDurations: periods with a start and an end, anchored to times or to moments, with notes and metadata like moments, drawn as bands on the timeline.Entity tags and separationTags on events: short labels such as war or trade, how to add them, filter by them, and separate a timeline into tracks by tag.ViewsA view is a saved way of showing a timeline: a set of separations, with their disjoins and unions, or an event's relationships, under a title.RelationshipsRelationships link two events on a timeline, drawn as arcs, and links join events across timelines: how to add, browse and remove them.Images and copyrightImages on timelines: icons, backgrounds and a timeline's own picture are linked where they are hosted, not copied, and what the service does with them.Searching a timelineSearch the open timeline by its events' titles and notes: how matching and ranking work, and how the server stores and serves the search.Browsing, popularity and account standingHow Explore lists, searches and ranks timelines and events: established accounts, standing against spam, popularity, trends and related timelines.Comparing timelines and live viewingCompare timelines side by side or combined on one axis, keep a comparison as a public page, and see others' edits live.Timelines from filesMake a timeline from the files on your computer in the desktop app: a moment for each photo, video, recording or document, at the time you choose.Shifting and scaling timesShift or scale the times of many events at once, for good: a whole timeline or the events a separation selects, by an offset or a factor.MeasuresExact quantities that moments and durations carry, such as a cost or hours worked: declared per timeline, given per event, and added up exactly.Timeline pluginsTimeline plugins: icons, headings, backgrounds, themes, charts and fields that extend moments and durations, where they run, and how to publish them.Timeline size and platformsHow large a timeline can be: up to 200,000 moments, durations and relationships, which platform suits which size, and how the app advises you.Guest and standalone editingEditing without an account: the guest editor and the offline HTML file keep timelines in memory, and how to keep your work before closing.

Sharing and working together

Accounts and the API

Running a server

Installing a serverInstall your own Circagraph server: a package for Debian, Ubuntu, Fedora, RHEL, Arch, FreeBSD, macOS or Windows, Docker Compose, Nix, or from source.Administration, storage limits and automationRun a Circagraph server: the first administrator, storage quotas, the landing page, IndexNow, page caching, terms, API keys and other operator settings.Docker deploymentRun your own Circagraph server with Docker Compose: public hosting, upgrades and backups, and email for account security.Nix and NixOSInstall Circagraph with Nix or NixOS: the flake's packages, nix-env without flakes, and the NixOS module that runs a server with PostgreSQL.Public example timelinesThe example timelines a new server can load: how to load them, the plugins and time conventions they use, and the World War II campaign comparison.Syslog to timelinesReceive syslog over UDP and TCP into timelines: each message becomes a moment, routed to timelines by rules, live, through the API.The systemd journal to timelinesFollow the systemd journal into timelines: each journal entry becomes a moment, live, routed to timelines by unit and fields, through the API.Importing log filesImport log files into timelines: syslog, Apache, nginx, JSON lines and journald exports, one moment per entry at its exact time, with its fields kept.GitHub to timelinesMirror GitHub, GitLab, Forgejo and Gitea issues, pull requests and commits into timelines, ongoing while open, by webhook or import.Boards and plans to timelinesMirror Trello, Jira, Planner, OpenProject and Microsoft Project cards, columns and Gantt plans into timelines, by webhook, polling or import.Copyright, GPLv3, and distributionsCircagraph's licence, the GNU GPL version 3: where the source and releases are, contributions, and how licence changes are handled.

How it works