circagraph01
Download
Offline browser HTML Desktop · Linux (.deb) Desktop · Linux (.AppImage) Desktop · Rocky / RHEL 10 (.rpm) Desktop · macOS Apple silicon (.dmg) Desktop · macOS Intel (.dmg) Desktop · Windows (.exe) Release notes & all downloads
Browser draft

Timeline controls

New here? The tour shows the main controls one at a time.

American soldiers wading ashore from a landing craft at Omaha Beach on D-Day, 6 June 1944 (Robert F. Sargent, "Into the Jaws of Death")

The Second World War around the world, with the road to it from 1919 and its end in 1945–46: the war in China from 1937, the war in Europe from 1939, the Eastern Front, North Africa, the Pacific, the Holocaust, the conferences and the surrenders. A sample built from the sources cited on each moment: Wikipedia, and the United States Holocaust Memorial Museum and Yad Vashem for the Holocaust.

How to read it. Chapter headings mark the stages of the war. Wars, theatres, campaigns, battles and sieges are durations (navy for the wars, brick for theatres, ochre for battles, dark violet for the Holocaust and the Nanjing Massacre); everything else is a moment, linked to what it led to. Tags pull out a thread: europe, eastern front, africa, asia, pacific, holocaust, diplomacy, home front.

Time. The line is in UTC. A moment known to its day sits at the start of that day, the date as historians give it. The few moments with a known local time (Poland, Kota Bharu, Pearl Harbor, D-Day, Trinity, Hiroshima, Nagasaki, the Berlin surrender, the Emperor's broadcast and the signing in Tokyo Bay) sit at their exact instant in UTC, with the local time in Date precision: so Hiroshima, 08:15 on 6 August in Japan, falls on 5 August on this line. Two moments on the same day are set a few hours apart, and say so.

Numbers. Death tolls are estimates, and labelled so; sources differ with what they count.

113 moments·A local draft, ready to explore
TimelineAll moments
→

Moment details

Separate

Each separation moves the events with any of its tags into a track of its own, above the rest of the timeline. Nothing is changed or saved.

    Views

    A view is a saved set of separations (tags, disjoins and unions, or an event's relationships) for showing this timeline a particular way.

    Save a view

    Who can see it

    Share a view

    Who can see it

    The link opens the timeline in this view, for those who can see it.

    Shared with

    Add a disjoin or union

    Kind

    Shift or scale times

    Each time becomes (time − around) × scale + around + offset, exactly, as comparisons align timelines. A duration’s start or end that follows a moment moves with that moment.

    Apply to

    Search this timeline

      Durations in this view

        Choose a moment

          Pull requests

          Discussion

          Recommend timeline changes

          Your draft becomes a pull request. The upstream timeline stays unchanged until someone with write access merges it.

          Timeline plugins

          Plugin suites

          A suite adds several plugins at once. Plugins this timeline already has stay as they are.

          Create a suite

          Package this timeline's plugins to add them to other timelines at once. The suite carries each plugin's definition, custom plugins included.

          Plugins

          Plugin editor

          Define metadata fields and a restricted render script. No DOM, network, imports, loops or arbitrary calls. Later plugins override earlier effects. Installing takes effect immediately; publishing makes this version public in the server library.

          Plugin library

          Popularity counts public timelines with the plugin enabled.

          Compare timelines

          Select two to eight timelines visible to your account, or add a JSON file.

          Choose a shared time display

          These timelines use different printers or parsers. Choose the display for this comparison. Original times stay unchanged; use scale and offset to align different coordinate conventions.

          Show

          Hide parts of the timeline while you read it. Only this tab is changed, not the timeline.

          Timeline

          Charts

          Measures

          Measures are exact quantities that events carry, such as a cost or hours worked. Each event gives its own values, and every value is exact.

          Timeline time display

          These settings belong to this timeline and are included in saved files and server copies. Times stay exact.

          Numeric labels are rounded. SI prefixes work best with unit symbols such as s. A Julian year is exactly 365.25 days.

          Displayed value = (stored time − origin) / scale. For Gregorian display, the displayed unit is one second from 1970-01-01T00:00:00Z.

          Preview uses the current window span and viewport width. Custom helpers: hasView(), viewLeft(), viewRight(), viewSpan(), viewWidth(), unitsPerPixel(), labelResolution(), purpose(). Existing printers and parsers can ignore this context.

          New timeline from files

          A moment for each file, dated as you choose. Its source is the file itself: open it from the moment in the file's own app. Nothing is copied, and file paths are never saved to a server.

          Folders and files
            Which files
            Date each moment by
            Metadata

            Servers

            The official server is https://circagraph.org. You can connect to your own HTTPS servers too, and sign in to several at once: your timelines from each are listed together. Local .och files work without a connection.

            Your Circagraph account

            Private timelines, collaborators, and public sharing.

            Registration and account security settings are available on the website.

            Share this timeline.

            Collaborators

            Edits saved meanwhile

            Keep your versions to replace what was saved, or use the saved versions to drop your edits to these. Your other edits are saved either way.

            Delete moment?

            Choose date and time

            Uses this timeline’s time display. Leaving the text unchanged preserves the exact coordinate, even when the display rounds it.