# 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. It runs on the website, as a desktop app for Windows, macOS and Linux, as a single offline HTML file, and on your own server. It is free software under the GNU GPL version 3, with no payments or paid features. Times are stored exactly, as whole numbers or fractions, so dates before year 1 and fractions of a second are kept as they are. ## Start here - [Explore timelines](https://circagraph.org/explore): search public timelines and their events by title and notes - [Frequently asked questions](https://circagraph.org/help/faq): Short answers to common questions about Circagraph: what it is, whether it is free, accounts, where data is kept, offline use, file formats and dates. - [Using Circagraph](https://circagraph.org/help/guide): A walk through Circagraph: making a timeline, adding moments and durations, zooming from millennia to fractions of a second, and sharing it. - [Download](https://circagraph.org/download): the desktop app, the offline file and server packages ## Who it is for - [Educators](https://circagraph.org/for/educators): Free, open-source timelines for teaching. Students read without an account and propose changes you review, and every moment can carry its sources. - [Researchers](https://circagraph.org/for/researchers): Circagraph for research: exact times at any scale, sources and date precision on each moment, saved history, and export in open formats. - [Investigators](https://circagraph.org/for/investigators): Circagraph for investigations: events and causal factors charts, sources and date precision on each moment, and the saved history of every revision. - [Operations](https://circagraph.org/for/operations): Circagraph for operations: syslog and journald receivers, a log importer for syslog, Apache, nginx and JSON lines, live updates and retention. - [Writers](https://circagraph.org/for/writers): Circagraph for writers and worldbuilders: story timelines and canons, storylines on tracks of their own, your world's calendar, and co-writers. - [Developers](https://circagraph.org/for/developers): Circagraph for developers: an HTTP API described in OpenAPI 3.1, scoped API keys, sandboxed plugins, log receivers and self-hosted server packages. ## Help - [Administration, storage limits and automation](https://circagraph.org/help/administration): Run a Circagraph server: the first administrator, storage quotas, the landing page, IndexNow, page caching, terms, API keys and other operator settings. - [HTTP API](https://circagraph.org/help/api): The HTTP API that the web app, the desktop app and the command-line tools use: its OpenAPI description, how to call it, and its warnings. - [Timeline and query contract](https://circagraph.org/help/architecture): How Circagraph stores and exchanges timelines: the .ochx and .och formats, exact times, window summaries, saved history and server operations. - [Accounts, sessions and deployment](https://circagraph.org/help/authentication): Sign-in on a Circagraph server: passwords, passkeys, two-factor codes, directory sign-in, human verification, and connecting the desktop app. - [Benchmarks](https://circagraph.org/help/benchmarks): How Circagraph's speed holds up as timelines grow: measured times for saves, searches, downloads and interactions on each storage backend. - [Boards and plans to timelines](https://circagraph.org/help/boards): Mirror Trello, Jira, Planner, OpenProject and Microsoft Project cards, columns and Gantt plans into timelines, by webhook, polling or import. - [Browsing, popularity and account standing](https://circagraph.org/help/browsing): How Explore lists, searches and ranks timelines and events: established accounts, standing against spam, popularity, trends and related timelines. - [Timeline size and platforms](https://circagraph.org/help/capacity): How large a timeline can be: up to 200,000 moments, durations and relationships, which platform suits which size, and how the app advises you. - [Dashboard and timeline collaboration](https://circagraph.org/help/collaboration): Working on timelines together: collaborators and permissions, forks and duplicates, saving while others save, pull requests, and saved history. - [Comparison of timeline tools](https://circagraph.org/help/comparison-of-timeline-tools): Circagraph beside TimelineJS, Aeon Timeline, Chronos, Time.Graphics, Preceden, Tiki-Toki and Timeline: dates, sources, size, offline use, price. - [Comparing timelines and live viewing](https://circagraph.org/help/comparison): Compare timelines side by side or combined on one axis, keep a comparison as a public page, and see others' edits live. - [Building and testing](https://circagraph.org/help/development): Run Circagraph from source: the development server, package managers, the offline file and its editions, the desktop app, tests, CI and releases. - [Docker deployment](https://circagraph.org/help/docker): Run your own Circagraph server with Docker Compose: public hosting, upgrades and backups, and email for account security. - [Durations](https://circagraph.org/help/durations): Durations: 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. - [Timelines from files](https://circagraph.org/help/file-populator): Make 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. - [GitHub to timelines](https://circagraph.org/help/github): Mirror GitHub, GitLab, Forgejo and Gitea issues, pull requests and commits into timelines, ongoing while open, by webhook or import. - [Guest and standalone editing](https://circagraph.org/help/guest-editing): Editing without an account: the guest editor and the offline HTML file keep timelines in memory, and how to keep your work before closing. - [Images and copyright](https://circagraph.org/help/images): Images 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. - [Installing a server](https://circagraph.org/help/install): Install your own Circagraph server: a package for Debian, Ubuntu, Fedora, RHEL, Arch, FreeBSD, macOS or Windows, Docker Compose, Nix, or from source. - [The systemd journal to timelines](https://circagraph.org/help/journald): Follow the systemd journal into timelines: each journal entry becomes a moment, live, routed to timelines by unit and fields, through the API. - [Copyright, GPLv3, and distributions](https://circagraph.org/help/licensing): Circagraph's licence, the GNU GPL version 3: where the source and releases are, contributions, and how licence changes are handled. - [Importing log files](https://circagraph.org/help/log-import): Import log files into timelines: syslog, Apache, nginx, JSON lines and journald exports, one moment per entry at its exact time, with its fields kept. - [Measures](https://circagraph.org/help/measures): Exact quantities that moments and durations carry, such as a cost or hours worked: declared per timeline, given per event, and added up exactly. - [Reports and moderation](https://circagraph.org/help/moderation): Reporting timelines and accounts, sensitive-content labels, and how a site's administrators review reports and restrict what breaks the rules. - [Nix and NixOS](https://circagraph.org/help/nix): Install Circagraph with Nix or NixOS: the flake's packages, nix-env without flakes, and the NixOS module that runs a server with PostgreSQL. - [Timeline plugins](https://circagraph.org/help/plugins): Timeline plugins: icons, headings, backgrounds, themes, charts and fields that extend moments and durations, where they run, and how to publish them. - [Relationships](https://circagraph.org/help/relationships): Relationships link two events on a timeline, drawn as arcs, and links join events across timelines: how to add, browse and remove them. - [Data retention and quick deletion](https://circagraph.org/help/retention): Keep only a timeline's recent past, for logs that keep growing; stop keeping saved history; and delete everything in a view. - [Searching a timeline](https://circagraph.org/help/search): Search the open timeline by its events' titles and notes: how matching and ranking work, and how the server stores and serves the search. - [Public example timelines](https://circagraph.org/help/seeding): The 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. - [Sharing timelines](https://circagraph.org/help/sharing): Share timelines: their addresses, links, the share dialog, previews, search engines, embeds, and showing them in other pages and AI chats. - [Syslog to timelines](https://circagraph.org/help/syslog): Receive syslog over UDP and TCP into timelines: each message becomes a moment, routed to timelines by rules, live, through the API. - [Entity tags and separation](https://circagraph.org/help/tags): Tags on events: short labels such as war or trade, how to add them, filter by them, and separate a timeline into tracks by tag. - [Shifting and scaling times](https://circagraph.org/help/time-mapping): Shift 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. - [Timeline time presentation](https://circagraph.org/help/time-presentation): How a timeline shows its times: calendar dates, numbers, units or your own format, with exact times underneath and dates before year 1. - [Views](https://circagraph.org/help/views): A 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. - [Project overview](https://circagraph.org/help/readme): 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. ## API - [HTTP API reference](https://circagraph.org/docs/api): every operation, who may call it, and example bodies - [OpenAPI 3.1 description](https://circagraph.org/api/openapi.json): the same, as JSON - [Making views](https://circagraph.org/help/views#the-api-making-views-from-scripts-and-ai-assistants): saved views of a timeline (separations, disjoins and unions) made with an API key: the JSON to send, with examples - [Showing a timeline in a chat reply or a page](https://circagraph.org/help/sharing#in-other-pages-and-ai-chats): the element (npm @openchronology/timeline): a timeline written as JSON inside it opens in the editor, with no server ## Public timelines - [openchronology/timeline-app on GitHub](https://circagraph.org/athan/2f4b15d5-a112-4d61-a04d-e61694d1b39d): The OpenChronology repository on GitHub, mirrored by och-import-github: issues and pull requests as durations (ongoing while open), what happened to them as… - [United States national debt · balances, borrowing and fiscal turning points](https://circagraph.org/athan/united-states-national-debt): A source-reconciled history of United States total federal debt outstanding in nominal dollars, from January 1, 1790 through 2026-11-09. The latest downloaded… - [Halo: an unofficial chronology](https://circagraph.org/athan/halo): The Halo universe from the Precursors to Zeta Halo: the games, novels, comics, and the live-action Forward Unto Dawn and Nightfall, in their own calendar… - [Ancient Egypt: from Narmer to Cleopatra](https://circagraph.org/athan/ancient-egypt): Ancient Egypt from its Predynastic cultures and its unification under Narmer to the death of Cleopatra VII and the Roman annexation in 30 BCE: its periods… - [Ancient Mesopotamia](https://circagraph.org/athan/mesopotamia): From the first farming villages, about 7000 BCE, through Uruk's first cities and writing, Sumer, Akkad, Ur, Hammurabi's Babylon, the Kassites and the Assyrian… - [China, from the Neolithic to 1949](https://circagraph.org/athan/china): Chinese history on one line: the Neolithic cultures, the Xia of tradition, the Shang and Zhou, the empire from Qin to Qing, and the Republic, to the founding… - [Type theory and functional programming: a history](https://circagraph.org/athan/type-theory): From Frege's Begriffsschrift and Russell's theory of types to the lambda calculus, Curry–Howard, ML and Haskell, dependent types and proof assistants, and… - [Middle-earth: an unofficial chronology](https://circagraph.org/athan/middle-earth): The legendarium from the Years of the Trees to the Fourth Age, in each Age's own reckoning (F.A., S.A., T.A., Fo.A.). Each event is tagged by the book that… - [French · history of sounds, writing and varieties](https://circagraph.org/athan/french-language-history): A history of French in speech and writing, following inherited sound patterns, contact, alphabets, manuscripts, print, codification and changing communities… - [The English language · sounds, writing and global varieties](https://circagraph.org/athan/english-language-history): A history of English as spoken and written, from reconstructed Germanic ancestry to twenty-first-century descriptions of global varieties. The timeline follows… ## Optional - [The help in full](https://circagraph.org/llms-full.txt): every help page above, as Markdown, in one file - [Source code](https://github.com/circagraph/timeline-app): the repository, its releases and issues