Chronicle
A day-by-day record of the calendar. Each entry carries that day’s notes alongside banners for season changes, moon phases, and recorded weather.
Opening the chronicle
Section titled “Opening the chronicle”- BigCal header button (if enabled in settings)
- MiniCal sidebar button (if enabled in settings)
- HUD bar button (if enabled in settings)
- Right-click context menu on any widget (Open submenu)
- Scene controls toolbar button (if Chronicle is added to toolbar apps)
- Journal sidebar footer button (if Show Journal Footer is enabled)
- Keybind (configurable, no default; see Keybinds)
- On world load (if “Show Chronicle on Load” is enabled)
- The API:
CALENDARIA.api.showChronicle()
The window
Section titled “The window”The Chronicle has no title bar. Drag it by its toolbar, and the position is saved and restored the next time it opens.
View modes
Section titled “View modes”Switch layouts with the view mode dropdown in the toolbar. Timeline is wider than Scroll, and the window resizes when you switch.
Scroll
Section titled “Scroll”Entries form a continuous vertical list. More entries load as you scroll near either edge.
Timeline
Section titled “Timeline”Cards alternate left and right along a vertical spine. Today’s entry gets a highlighted node on the spine and a Today badge.
Weekly almanac
Section titled “Weekly almanac”The almanac publishes a per-week summary of the same weather, moon, and note data. Each almanac page links back to the Chronicle locked to that week. See Weekly Almanac.
Entries
Section titled “Entries”Each entry is one day.
| Element | Description |
|---|---|
| Date | Formatted date and weekday name |
| Notes | Calendar notes with icon, color, title, and content |
| Festivals | Festival-linked notes highlighted with a festival indicator |
| Banners | Season changes, moon phase milestones, and weather history (see below) |
Click a note to open it in view mode. Hovering an entry reveals a “Record an entry” button for anyone who can create notes. The button creates a note on that date and opens it for editing.
Banners
Section titled “Banners”| Banner | When it appears |
|---|---|
| Season | Two per transition: the outgoing season ends on its last day, the incoming one begins on the next |
| Moon phase | The midpoint of each moon phase |
| Weather | Recorded weather on past days and today |
Banners are hidden while the Category Filter or the Subject Filter is active.
Fog of war
Section titled “Fog of war”When Fog of War is enabled, unrevealed dates display as fogged placeholders. You see full content regardless of fog state.
Depth modes
Section titled “Depth modes”The depth dropdown sets how much note content is shown.
| Mode | Description |
|---|---|
| Title Only | Note icon, color, and title only |
| Excerpts | Title plus a plain-text excerpt |
| Full | Title plus full rendered content |
In Excerpts, a note whose text runs past the excerpt limit shows its opening text with a chevron that expands the rest in place. A shorter note shows in full with no chevron, and Full mode has none.
The Chronicle settings tab carries a fourth option, Collapsible.
Toolbar
Section titled “Toolbar”| Control | Description |
|---|---|
| Today | Reset the date range and scroll to today’s entry |
| Show Empty Days | Toggle display of days with no notes or banners |
| Category Filter | Show only notes in the selected categories |
| Subject Filter | Show only notes naming the selected subjects |
| Depth Dropdown | Switch between depth modes |
| View Mode | Switch between Scroll and Timeline layouts |
| Close | Close the Chronicle |
A filter button appears only once a note uses the thing it filters on. Each menu lists the values notes actually use rather than every value defined. A badge on the button counts the active selections, and the menu carries a Clear option.
The subject list draws from every document a note names as a subject. The subject selection is per-window and resets when the Chronicle closes.
While either filter is active, Show Empty Days has no effect, and only days holding a matching note appear.
Right-click the toolbar to access:
| Option | Description |
|---|---|
| Chronicle Settings | Opens the Chronicle settings tab |
| Open | Submenu to open other Calendaria widgets |
| Show to All / Hide from All | Toggle Chronicle visibility for all players (GM only) |
| Close | Close the Chronicle |
Live updates
Section titled “Live updates”The Chronicle refreshes when notes change, weather updates, the day advances, fog of war shifts, the active calendar switches, or settings change.
See API Reference for developer methods.