winget install --id=AGSoto.TimelineTimer -e Timeline Timer is an edge-docked visual timer that maps agenda items to a live timeline for presentations, teaching, workshops, and focused work.
See the whole session, not just the next countdown.
Timeline Timer is a small, always-on-top desktop HUD that turns a plain-text agenda into a continuously moving visual timeline. Dock it to any screen edge, see where you are at a glance, and keep the rest of the screen available for the work that matters.
It is designed for situations where a normal countdown hides too much context:
Write a label followed by a duration. Newlines, bullets, dashes, numbered lists, combined durations, and long or short unit names are accepted.
☕ Welcome 5m
1. Architecture review 1h30m
- Questions 45 seconds
✅ Wrap-up 10m
Paste the agenda into Timeline Timer and start. The timeline scales each segment to its duration so both the current moment and the remaining shape of the session stay visible.
Windows, Linux, and macOS installers are published on the repository's Releases page. Choose the MSI or setup executable on Windows, the DMG matching your Mac processor, or the AppImage, DEB, or RPM on Linux.
Packages are currently unsigned, so Windows SmartScreen or macOS Gatekeeper may display a warning.
Timeline Timer uses the WinGet package identifier AGSoto.TimelineTimer. Once the current manifest has been accepted into the WinGet community repository, install or upgrade it with:
winget install --exact --id AGSoto.TimelineTimer
winget upgrade --exact --id AGSoto.TimelineTimer
Every release includes SHA256SUMS.txt, containing the SHA-256 digest of each packaged asset. On Windows, compare a downloaded installer's hash with that file using:
Get-FileHash '.\Timeline.Timer_0.1.1_x64_en-US.msi' -Algorithm SHA256
Prerequisites are Node.js 20.19 or newer, Rust, and the Tauri v2 system dependencies for your platform.
npm install
npm run tauri dev
Timeline Timer has primarily been developed and tested on Windows. See Windows development and troubleshooting for one-time setup, a single-command launch, and fixes for Cargo, the MSVC linker, Windows SDK libraries, and icon errors.
For browser-only UI development, run npm run dev.
| Key | Action |
|---|---|
Space / Ctrl+P | Start, pause, or resume |
Ctrl+R | Restart |
Arrow keys / Home / End | Select an item |
Enter | Edit the selected item |
Delete | Remove the selected item |
Ctrl+N / Ctrl+D | Add / duplicate an item |
Ctrl+Up / Ctrl+Down | Reorder the selected item |
+ / - | Add / remove one minute from the focused item, or the current item when none is focused |
S | Skip the current item |
Ctrl+E / Ctrl+L | Focus the editor / timeline |
Ctrl+K | Toggle editing lock |
Ctrl+Alt+C | Toggle compact mode |
Ctrl+, | Open settings |
Alt+Shift+Arrow | Dock to that screen edge |
Escape | Close the active prompt/editor, or clear timeline-item focus |
When the remaining-time prompt is visible, keys 1–4 add 3, 5, 10, or 15 minutes.
Settings control the dock edge and margin, compact label length, compact time counters, and accent color. Resize the window directly to change its horizontal height or vertical width; those dimensions are restored independently for each orientation. Preferences are persisted and applied immediately. Appearance and layout can be reset independently, or every setting can be restored to its default without removing the agenda.
The desktop app also creates custom.css in its platform application-config directory on first launch; the exact path appears in Settings. Changes are applied while the app is open. Override the variables in :root or any application selector. The base --accent-rgb, --hud-rgb, --white-rgb, and --black-rgb channels drive the derived translucent colors, while semantic tokens can be overridden individually.
Optional bundled themes are intentionally deferred until the core experience is mature.
Pull requests are welcome. Read CONTRIBUTING.md for setup, checks, and review expectations. Bugs and focused feature ideas are also welcome through GitHub Issues.
For maintainers, RELEASING.md documents versioning and the automated multi-platform release flow. Notable changes are tracked in CHANGELOG.md.
Timeline Timer is available under the MIT License.