Radial timeline

Radial Timeline™

by Eric Rhys Taylor

Shell execution and Direct filesystem access are used for Pandoc manuscript publishing. See Privacy & Security.

Try It

• Website — Radial Timeline and its companion plugin, Editorialist, feature by feature.
• Demo vault — Pride & Prejudice, a finished novel fully mapped in the timeline with AI analysis included.
• Newsletter — release news and notes from the workshop.
• Community — writers sharing books in progress and answering each other's questions.

What It Does

Radial Timeline® arranges your scenes by act, subplot, narrative or chronological order in a striking radial layout—revealing the structure, rhythm, and scope of your story. Each ring represents a subplot; hover interactions surface important details like scene synopsis and AI story pulses. Scenes highlight across subplots to show interrelationships. Multiple view modes present your novel like an X-ray.

Radial Timeline® captures and visualizes four core timelines, letting you see manuscript order, story chronology, writing progress, and revision stage in one connected view.

• Narrative time: the sequence you reveal events to readers.
• Chronological time: when events happen in your story's world.
• Author time: your scene writing progress with target due dates tracking Todo, Working, Complete, and Overdue.
• Progress stages: manuscript revision stages from Zero draft through Press-ready.

The mode buttons run in this order: Progress, Narrative, Chronologue, and Gossamer. Narrative and Chronologue keep subplot colors front-and-center so you can compare structure without workflow noise. When you need to see Todo/Working/Overdue status or progress stage colors, switch to Progress Mode, where the combined outer ring is replaced by a single-subplot view and scenes inherit the author-status and progress-stage palette.

Docs (How-to & Setup)

If you want the "how-to" details (setup, sets, properties, reordering, advanced options), they live in the wiki:

• Wiki Home
• How-to
• Settings
• Commands
• YAML Frontmatter

Sets, Properties, and Templates

• Sets define the structural fields used in your notes.
• Properties are custom metadata fields added to notes.
• Presets are starter configurations for campaigns or workflows.
• Templates are used only for export formatting (e.g., Pandoc).

Watch

Ongoing series on the Radial Timeline YouTube channel:

• Volume 2 — Chronologue Mode: Chronologue Mode Volume 2
• Volume 3 — Release 6 Overview: Overview of New Features
• Volume 4 — Inquiry View: Inquiry View Volume 4
• Volume 5 — Author Progress Report (APR): Author Progress Report (APR) Volume 5
• Volume 6 — Gossamer Mode: Gossamer Mode Volume 6
• Volume 8 — Community: Radial Timeline Community Volume 8
• Volume 9 — Editorialist: Turn Your Editor's Notes Into a Revision Schedule
• Volume 10 — Quick Start: Quick Start Volume 10
• Volume 11 — Manuscript Export: Obsidian Writers: Turn Your Notes into a Finished Manuscript
• Volume 13 — November Writers' Month: Writing a Novel This November? Come Write With Me

Shorts:

• Book Designer: Build Your Novel Structure Instantly
• Timelapse: Watch a Novel Progress Across Scenes & Subplots

Installation

From Obsidian

• Open settings → community plugins.
• Click browse and search for "radial timeline".
• Click install and then enable.

Manual installation

• Download the latest main.js, styles.css, and manifest.json from the releases page.
• Extract the files to your vault's .obsidian/plugins/radial-timeline (may be hidden by file system).

Desktop & Platform Support

Radial Timeline is a desktop-only Obsidian plugin.

• Supported target: Obsidian Desktop
• Not intended for: Obsidian Mobile
• Some publishing and file-reveal workflows depend on desktop filesystem and native shell access

Language Support

Radial Timeline follows your Obsidian language, with interface catalogs for English, German, Japanese, Korean, Simplified Chinese, Spanish, French, Thai, and Vietnamese. Missing translated strings fall back to English. Regional variants use the matching base language; Traditional Chinese variants fall back to English until a dedicated Traditional Chinese locale is available.

Privacy & Security

• No telemetry or analytics SDKs are shipped with the plugin.
• API keys use Obsidian secret storage when available.
• AI ships off by default — new installs make no AI connection and transfer no data until you enable Settings → AI → Enable AI LLM features and configure either a cloud provider API key or a local AI server. Existing installs keep whatever choice they already made; upgrading never flips this setting for you.
• Vault content should only leave the vault when you explicitly use enabled external features.
• Shell commands are run only to invoke Pandoc (and its LaTeX engine) when you export a manuscript, and to probe for those binaries with which/where during setup.
• Files outside the vault are read or written only to save exports where you choose and to locate the Pandoc executable.
• The only environment variable read directly is PATH, used to locate Pandoc. Subprocesses receive a minimal allowlisted environment (PATH, home, temp, and locale/TeX variables) — never the full set, so credentials in your session can't leak to child processes.

See Privacy & Security for the detailed posture.

External Services & Network Access

Radial Timeline may contact external services in these workflows:

• AI provider requests when you actively use enabled AI features
• Optional provider/model/pricing metadata refreshes governed by AI privacy settings
• A version check against the GitHub Releases API runs once at plugin load (throttled to once a day). It carries no vault data or identity; it only compares version numbers so the timeline can show an update indicator.
• Community mailbox: on a vault connected to the Community, while a timeline is open, the plugin asks the Community about once an hour (and when Obsidian regains focus) whether you have unread replies. It sends the connection's id and secret and gets back counts. Turn it off with Show Community mailbox in Settings → Advanced
• Community Share calls: once you connect, your Book Manager book titles (or public labels), loglines, and target dates sync to your private My Share list as project shells at every level; report publishing and daily-activity sync are sent only at a sharing level above Private — see Settings → Community

Known Conflicts

Plugin conflicts: If you experience visual glitches or strange behavior (such as the timeline overlapping with other UI elements), it may be due to a conflict with another plugin. Try disabling other plugins to isolate the issue. Please see known plugin conflicts, and Getting help for known issues and where to report a new one.

Technical Notes

The radial timeline is designed for high pixel density displays (around 200 ppi or higher) for optimal visual quality.

• All Apple Retina displays — 2x pixel density.
• Recommend Windows systems with 4k displays or higher. (Tested down to 1440p 2560x1440)
• Tablets.

If you're experiencing visual quality issues on Windows, please check your display scaling settings.

Acknowledgments

• 04 Font by Yuji Oshimoto — Japanese freeware font. © 1998–2003 Yuji Oshimoto.
• d3.js — data-driven SVG visualizations.
• Hero Patterns by Steve Schoger — SVG motifs used in the Working-status scene fill, under the Creative Commons Attribution 4.0 International License.
• JetBrains Mono by JetBrains — used for the title-bar writing session counter.
• Obsidian — for a thriving plugin ecosystem and thoughtful feature development.
• Save the Cat! Writes a Novel (2018), Jessica Brody — a practical articulation of the Save the Cat beats.
• The Story Grid, Shawn Coyne — a rigorous methodology for analyzing scenes and beat flow.
• W3C SVG specification — for making vector graphics on the web dependable.

Bundled fonts (PDF export)

• Latin Modern Roman — used for the Signature template.
• Sorts Mill Goudy by Barry Schwartz — used for the Professional template.
• Source Serif 4 by Frank Grießhammer — used for the Standard template.
• Arial — used for the Basic template.

All bundled fonts ship with their original license files in assets/fonts/.

Feedback and Support

Every way to get help is on one page: Getting help, also one click away from GET HELP in the corner of the Radial Timeline View.

• Quick answers and writers helping writers: the Radial Timeline Community, where writers share setups and answer each other's questions.
• Private bug reports and help requests: Community Requests (sign in with your Community account). A person reads every request on weekdays; expect a reply within three working days.
• Plugin bugs on GitHub: the bug icon (Report a bug) in the Radial Timeline and Inquiry views opens the bug report form with your versions filled in.
• Step-by-step answers: the Guide.
• Feature ideas: the feature idea form, or share it with other writers on the Community.

Author

Created by Eric Rhys Taylor

Reviewed and approved for the Obsidian Community Plugins directory. Developed with best practices in mind.

License & Intellectual Property

Radial Timeline® © 2025 Eric Rhys Taylor Released under the Radial Timeline Source-Available Non-Commercial License.

• You may install and use the software for personal, educational, or professional creative work.
• You may use the software to create commercial creative works such as books, scripts, outlines, and related authored content.
• Redistribution, public forks, hosted versions, and commercial exploitation of the software itself are prohibited without written permission.
• Radial Timeline is protected by U.S. Copyright Registration TX0009593938 and U.S. Trademark Registration No. 8,251,843.
• The Radial Timeline visualization system is the subject of a pending U.S. patent application and is marked Patent Pending.

See the Legal page on the wiki for a plain-English permission table, the License text, and the Notice file.

Disclaimer & Limitation of Liability

This software is provided "as is" without warranty of any kind, express or implied.