Session Clock is a precision focus timer built on one idea: the environment you work in shapes the quality of your work. 103 animated canvas themes (each with its own bespoke intro transition), a synthesized ambient sound mixer with crossfade scenes, binaural audio, session intelligence, voice control, and Zen Mode — running entirely locally with zero backend.
| Themes | 103 animated, each with a custom intro — TV, film, animation, anime, F1, natural |
| Sound Mixer | 17 synthesized ambient tracks · crossfade scenes · night mode · live VU meter |
| Music | Opt-in player, hidden by default · YouTube-first · Spotify only when selected |
| Now Playing | Matches ~30 soundtracks against Spotify (or any player, manually) and switches theme |
| Modes | Pomodoro (fully custom cycles) · Zen · Calm · Focus · Kiosk · PiP · Voice |
| Intelligence | Streaks · Velocity · Flow Intensity · Configurable break reminders |
| Always on Top | Document PiP — mini clock floats over other apps |
| Languages | EN ES FR DE JA KO PT HI |
| Privacy | Zero backend · localStorage only · No tracking |
→ Full documentation on the Wiki · → Changelog
Check CHANGELOG.md for the version details.
git clone https://github.com/ADJ189/Session-clock
cd Session-clock
npm install # one-time dependency fetch
npm run dev # localhost:5173
npm run typecheck # strict TypeScript check
npm run test:unit # Node unit suite
npm run test:e2e # Playwright, five browser projects
npm run build # production → dist/Requires Node.js 24+ and npm. The repository declares engines.node: ">=24"
in package.json, and CI installs Node 24. The main development, test, and CI
workflow runs on the installed Node toolchain. Deno is optional: deno.json
mirrors the same tasks (deno task test:unit, deno task test:e2e) for local
use, without changing any npm script or the production build. The Deno tasks
call the installed node_modules/ binaries and do not modify them, so using
Deno locally never breaks the npm entry points.
Push to main → Settings → Pages → GitHub Actions to deploy. The included workflow handles typecheck → build → deploy automatically.
Space start/pause · Z Zen Mode · T next theme · Ctrl+K command palette · Esc exit
🎮 8-BIT — ↑↑↓↓←→←→BA · 🔥 Phoenix — 100 sessions · 🍳 The Bear — type thebear
Bug reports and PRs are welcome — see CONTRIBUTING.md for setup, project layout, and how to configure OAuth for local dev. Third-party fonts, APIs, and tooling are listed in CREDITS.md.
AGPL-3.0 — free to use and fork; modifications must be open-sourced.
Made with ❤️ by ADJ189
"Focus is the art of knowing what to ignore."

