Skip to content

About

An open-source study and focus workspace featuring customizable session timers, immersive ambient soundscapes, and productivity tools — designed to help you stay focused and make every study session count.

Topics

Resources

Contributing

Security policy

Stars

1 star

Watchers

0 watching

Forks

Latest commit

 

History

775 Commits

Folders and files

NameName
Last commit message
Last commit date
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 

Repository files navigation

Session Clock logo

Session Clock

A cinematic focus timer. Every theme is a world.

TypeScript Zero deps PWA License: AGPL v3 CodeQL

Session Clock app preview — a centred clock, a compact session timer, and the optional music dock

Open App →  ·  Wiki →  ·  Issues


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


Latest Version : 2.0.0

Check CHANGELOG.md for the version details.


Quick Start

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.


Key Shortcuts

Space start/pause  ·  Z Zen Mode  ·  T next theme  ·  Ctrl+K command palette  ·  Esc exit

→ All shortcuts on the Wiki


Secret Themes

🎮 8-BIT — ↑↑↓↓←→←→BA  ·  🔥 Phoenix — 100 sessions  ·  🍳 The Bear — type thebear

→ All easter eggs on the Wiki


Contributing

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.

License

AGPL-3.0 — free to use and fork; modifications must be open-sourced.


28 modules · 1 runtime dep (anime.js) · 103 themes · 17 ambient sounds · 20+ easter eggs · 8 languages · Flow Intensity

Made with ❤️ by ADJ189

"Focus is the art of knowing what to ignore."

About

An open-source study and focus workspace featuring customizable session timers, immersive ambient soundscapes, and productivity tools — designed to help you stay focused and make every study session count.

Topics

Resources

Contributing

Security policy

Stars

1 star

Watchers

0 watching

Forks

Used by

Contributors

Languages