Obsidian - Aprils Automatic Timelines
Based on Josh Plunkett's video on YouTube. If you like this content, support the original creators by watching, liking and subscribing to their content.
April’s Automatic Timelines builds a vertical RPG timeline in Obsidian by pulling event data from each event note’s front matter.
Briefing
April’s Automatic Timelines turns Obsidian notes into a clean, vertical timeline for tabletop RPG campaigns—pulling event titles, dates, summaries, and optional images directly from each event note’s front matter. The big practical win is that it keeps event data in the vault as plain markdown files, avoiding the “data.json disappearing” anxiety that has surrounded Fantasy Calendar’s storage layer during its rebuild.
Setup starts with installing the Community plugin “April’s automatic timelines,” then configuring which front matter keys hold the timeline’s start date, end date, title, body, and picture. Out of the box, the plugin expects a specific set of keys (like AET event title and AET event body), but the configuration can be adjusted to match a user’s own templates. A key integration point is Fantasy Calendar support: enabling Fantasy Calendar presets lets the timeline read FC-style fields (FC date, FC end, FC display name, FC calendar, and FC category) so both systems stay synchronized.
Event notes are where the timeline magic happens. Each note includes front matter wrapped in triple-dash delimiters, with a render flag (render enabled) that determines whether the note appears on the timeline. The note also declares a timeline name (timelines), and can optionally define multiple timeline names—useful for splitting content into a “master” timeline and smaller year-based timelines. The plugin uses the note’s front matter to decide where it lands on the timeline, and it sorts by the configured date fields rather than the filename.
When rendered, each timeline entry shows an image (the first image in the note), an event title, a short two-line summary drawn from the note content, and a clickable entry that jumps to the underlying note. Overlapping or closely spaced dates cause the timeline’s side markers to break into multiple lines, creating a more readable visualization when events cluster.
A notable advanced feature is configurable date parsing via regex. By default, the plugin assumes a day-month-year format, but the parser can be changed to support “funky” date formats—so campaigns that store dates differently can still generate correct placements. The transcript also flags that this regex-based configuration may change as the plugin’s maintainers simplify it, so checking the readme is recommended.
For users already relying on Fantasy Calendar, the workflow becomes even smoother: Fantasy Calendar can read the same front matter fields from notes, meaning events can be stored once and displayed in both places. The transcript advises keeping events as notes rather than relying on Fantasy Calendar’s UI-created entries, citing reports of issues with the underlying data.json.
Finally, the plugin’s limitations are straightforward: there’s no horizontal timeline option at present, and it won’t work with Obsidian Publish because plugins generally don’t run there. Still, the overall result is a fast, template-driven way to build RPG campaign indexes—potentially even chapter-by-chapter book navigation—using nothing more than structured note front matter and a rendered timeline view.
Cornell Notes
April’s Automatic Timelines generates a vertical timeline in Obsidian by reading event details from each event note’s front matter. Each note includes a render-enabled flag, a timeline name (timelines), and date fields (start/end) plus optional title, body, and picture keys. When Fantasy Calendar presets are enabled, the timeline can use FC date fields and stay consistent with Fantasy Calendar’s own front matter-driven event system. The plugin also supports a regex-based date parser for nonstandard date formats and shows a short two-line summary plus a first-image thumbnail per event. Storing events as notes reduces risk compared with relying on Fantasy Calendar’s data.json during its rebuild.
What front matter fields does April’s Automatic Timelines need to place an event on the timeline?
How does the plugin decide whether a note appears, and how can one note belong to multiple timelines?
What does a rendered timeline entry show, and where does the summary text come from?
How does Fantasy Calendar integration change the workflow?
Why is date parsing configuration important, and what’s the role of regex?
What are the practical limitations mentioned for publishing and layout?
Review Questions
- If a timeline entry doesn’t appear, which two front matter conditions should be checked first (based on the transcript)?
- How can one event note be made to appear in both a master timeline and a year-specific timeline?
- What risks does the transcript associate with storing events in Fantasy Calendar’s data.json instead of as notes, and how does April’s plugin help mitigate that?
Key Points
- 1
April’s Automatic Timelines builds a vertical RPG timeline in Obsidian by pulling event data from each event note’s front matter.
- 2
The plugin renders only notes marked render enabled: true and tied to the correct timeline name(s) in timelines.
- 3
Fantasy Calendar presets let the timeline use FC date fields (FC date/FC end plus FC display name, FC calendar, and FC category) so both tools stay aligned.
- 4
Each timeline card can show an image (first image in the note) and a short two-line summary rather than the entire note body.
- 5
Date placement relies on configured start/end keys, and regex-based day parsing can support nonstandard date formats.
- 6
Storing events as notes reduces dependence on Fantasy Calendar’s data.json during its rebuild, which has caused missing data for some users.
- 7
The plugin currently won’t work on Obsidian Publish and has no horizontal timeline option yet.