Skip to content

Repository files navigation

Focus

A quiet Pomodoro timer for your own focus sessions. Warm white, simple controls, no account or tracking.

Load unpacked

Works in Chrome and other Chromium browsers (Edge, Brave, Arc, and similar).

  1. Open chrome://extensions (in Edge, edge://extensions).
  2. Turn on Developer mode, then choose Load unpacked.
  3. Select this folder (the one that contains manifest.json).
  4. Pin Focus from the extensions menu.
  5. Click Focus and press Start. It pings when the time is up.

Keep this folder in place: the browser loads the extension from it. If an older copy is installed, disable it to avoid two timers.

Your sessions

  • Defaults: 25 minutes of focus and a 5-minute break.
  • Pause, resume, or end a session from the popup.
  • Close the popup at any time; the browser alarm keeps your session scheduled.
  • Settings: focus 1–120 minutes, break 1–30 minutes, end sound, and automatic cycling.
  • Settings save as you change them. Duration changes apply to the next session.
  • Automatic cycling is off on a fresh install. Existing preferences survive updates.
  • After an overdue session, reopening the browser or popup recovers the completion. A session overdue by a minute or more does not automatically start another session.
  • Browser alarms cannot wake a sleeping computer or play while the browser is fully quit. Alerts can be delayed; system notification settings may suppress notifications.

All settings and timer state stay in the browser's local extension storage. Permissions cover local storage, alarms, notifications, and a hidden audio document. No website access or browsing history permission is requested.

Check the timer engine

Run node --test tests/background.test.cjs. No package install or build is needed.

About

No description, website, or topics provided.

Resources

Stars

1 star

Watchers

1 watching

Forks

Releases

Packages

Used by

Contributors

Languages