Time Keeper
Time-only display with a small footprint.
Opening the Time Keeper
Section titled “Opening the Time Keeper”- The Toggle Time Keeper keybind. See Keybinds.
- The Time Keeper button on the scene-controls Notes toolbar, shown when Time Keeper is enabled under Toolbar Apps.
- The Time Keeper button in the journal sidebar footer, shown when the journal footer is enabled.
- The Open Time Keeper button on the Time Keeper tab in Settings.
- On world load, when Show Time Keeper on Load is enabled.
CALENDARIA.api.showTimeKeeper()andCALENDARIA.api.toggleTimeKeeper().
None of these open the Time Keeper for a user without the View Time Keeper permission. See Permissions.
Features
Section titled “Features”- Fixed compact width
- Controls hidden on idle, revealed on hover, for a user with the Change Date/Time permission
- Play/pause button revealed over the time display on hover, for a user with the Change Date/Time permission
- Shift-click the play/pause button to lock or unlock the clock
- Right-click context menu for settings, visibility, position controls, and tray pinning
- Four configurable time-jump buttons per increment type
- Date display hidden by setting the Time Keeper date format to “off”
- Draggable via the time display area
Controls
Section titled “Controls”Hover to reveal. The tray renders only for a user with the Change Date/Time permission, and hovering reveals no controls for anyone else.
| Button | Action |
|---|---|
| Fast Reverse (<<) | Jump backward by the dec2 amount |
| Reverse (<) | Jump backward by the dec1 amount |
| Increment selector | Set step size |
| Forward (>) | Jump forward by the inc1 amount |
| Fast Forward (>>) | Jump forward by the inc2 amount |
The increment selector offers Second, Round, Minute, Hour, Day, Week, Month, Season, and Year. Month is omitted on a monthless calendar. Scroll the wheel over the selector to step through the options, which stop at the first and last entry. The selected increment is remembered per user across sessions.
Jump amounts differ per increment type. Configure them on the Time Keeper tab in Settings.
Context menu
Section titled “Context menu”Right-click the Time Keeper to access:
| Option | Description |
|---|---|
| Time Keeper Settings | Opens the Settings Panel to the Time Keeper tab |
| Show to All / Hide from All | Toggles forced display for all players, GM only |
| Reset Position | Resets to the default position and clears sticky zone snapping |
| Lock/Unlock Position | Toggles whether the Time Keeper can be dragged; shows a notification when toggled |
| Pin/Unpin Controls | Keeps the hover-revealed controls tray open instead of auto-hiding when the mouse leaves |
| Open | Opens a submenu to launch any Calendaria application: BigCal, MiniCal, HUD, Time Keeper, Stop Watch, Sun Dial, and Chronicle |
| Close | Closes the Time Keeper |
Show to All opens the Time Keeper for every player with the View Time Keeper permission, and turns on Show Time Keeper on Load. While it is on, a player who tries to close the Time Keeper gets a warning that the window cannot be closed. If a connected user lacks the View Time Keeper permission, a warning names that user when you turn Show to All on. Hide from All closes the Time Keeper for every player.
Position controls
Section titled “Position controls”- Reset Position: Returns the Time Keeper to its default coordinates and clears any sticky zone snapping
- Lock/Unlock Position: Prevents dragging when locked; available via the context menu or the Time Keeper tab in Settings; shows a notification when toggling
Sticky zones
Section titled “Sticky zones”To snap the Time Keeper into place, drag it near a sticky zone. It wobbles while a zone is in range. See HUD > Sticky zones for zone locations.
Position is saved per user and restored on the next load, including the zone it was snapped to.