Stop Watch
A draggable dial for timing something, in real time or in world time.
Opening the stop watch
Section titled “Opening the stop watch”- Press Alt+W to toggle visibility
- Toolbar button (if enabled in Settings Panel > Module tab > Toolbar Apps)
- Journal footer button (if enabled)
- Settings Panel > Stop Watch tab (Open Stop Watch and Close Stop Watch buttons)
- On world load (if Show Stop Watch on Load is enabled)
- The API:
CALENDARIA.api.showStopwatch()
Display
Section titled “Display”The dial is numbered to 60 seconds around its edge. The second hand completes one turn per minute. The sub-dial below the center completes one turn per 30 minutes.
Elapsed time reads out in digital text at the center of the face, with the control buttons directly above it. Set the format for each mode on the Stop Watch tab in Settings.
Display modes
Section titled “Display modes”| Mode | Description |
|---|---|
| Real Time | Counts real seconds regardless of game state |
| World Time | Counts elapsed world time, in the calendar’s own time units |
To switch modes, click the mode button. Switching clears the elapsed time, stops the stop watch, and discards the recorded laps.
Real time mode
Section titled “Real time mode”Counts real seconds. It keeps running while the game is paused.
World time mode
Section titled “World time mode”Elapsed time is measured from Foundry’s world time. It advances whenever world time advances and holds still whenever world time does.
The readout divides that elapsed time using the active calendar’s hours per day, minutes per hour, and seconds per minute rather than real hours and minutes. On the default hours-minutes-seconds format, elapsed time past one calendar day picks up a day prefix.
With Auto-Start World Time enabled, starting the stop watch in world-time mode also starts the world clock.
Controls
Section titled “Controls”| Button | Action |
|---|---|
| Notification | Configure a threshold alert |
| Lap | Record the current elapsed time as a lap |
| Start/Pause | Toggle the stop watch running state |
| Reset | Clear elapsed time and lap history |
| Mode | Switch between real time and world time |
Keyboard shortcuts
Section titled “Keyboard shortcuts”Toggle Stop Watch is bound to Alt+W. The Start/Pause and Reset keybinds are unbound. See Keybinds for configuration instructions.
Persistence
Section titled “Persistence”Each user has their own stop watch. Starting or resetting yours does not touch anyone else’s.
The running state, elapsed time, laps, and notification settings are saved as you use them. A stop watch left running reopens on the next world load and keeps counting from where it was. In real-time mode that includes the time the world spent closed.
Lap timing
Section titled “Lap timing”To record the current elapsed time, click Lap. Lap is available only while the stop watch is running, and is dimmed and inactive while it is stopped or paused.
Laps appear in a scrollable list below the face. Each lap shows its number and the cumulative elapsed time at that lap. To clear them, click the trash icon in the laps header.
Threshold notification
Section titled “Threshold notification”To configure a notification, click the bell icon. The threshold is entered in seconds: real seconds in real-time mode, world-time seconds in world-time mode. Pick a notification type, either a toast, a sound, or both, and a sound file. Clear removes the threshold.
The bell stays highlighted while a threshold is set. The notification fires once, then re-arms the next time you start, reset, or switch modes.
Context menu
Section titled “Context menu”Right-click the stop watch face to access:
| Option | Description |
|---|---|
| Reset Position | Restore the default position and clear any sticky zone snapping |
| Lock/Unlock Position | Toggle position locking |
| Show to All / Hide from All | Toggle forced visibility for all players (GM only) |
| Open | Submenu to open any of the other Calendaria apps |
| Close | Close the stop watch window |
Positioning
Section titled “Positioning”Dragging
Section titled “Dragging”The stop watch is frameless and has no title bar. Drag it by the watch face to reposition it.
Resizing
Section titled “Resizing”Drag the bottom-right resize handle to resize the stop watch.
Sticky zones
Section titled “Sticky zones”The stop watch snaps to predefined screen positions when dragged nearby. See HUD > Sticky Zones for zone locations.