A desktop interval/countdown timer for Windows, built with Electron. Designed for work/break cycles (Pomodoro-style), with alarms that can play a local sound file, a YouTube video, or a Spotify track.
- Interval Timer — configurable work/break durations and loop count, with a running phase/status display.
- Countdown Timer — a simple one-shot timer, separate from the interval loop.
- Presets — save and switch between named timer configurations; three seeded defaults plus up to 20 of your own.
- Alarm sources — a local audio file, a YouTube video/URL, or a Spotify track, with automatic fallback to the local alarm if a source fails to load or play. Spotify alarms currently have no reliable preview clip playback — full-track playback needs Widevine support that stock Electron doesn't ship, and Spotify's non-DRM preview-clip API isn't available for every track.
- Pause / Continue — every alarm source resumes correctly rather than losing its duration cap or restarting from zero.
- Mini window — a small always-on-top window that mirrors and controls the active timer, and stays above other apps even when they go fullscreen.
- System tray — runs in the tray; keeps ticking in the background thanks to disabled timer throttling and a power-save blocker.
Grab the installer from the latest release and run it. No Node.js or build tools required.
git clone https://github.com/psymore/interval-timer.git
cd interval-timer
npm install
npm start # run the app (electron .)Other scripts:
npm run dist # clean dist/ and build a Windows x64 installer (nsis)
npm run build # clean dist/ and package with electron-builder
npm run clean # remove dist/There is no test suite or lint script configured.
Downloaded releases ship with the maintainer's own Spotify app credentials, so Spotify alarm selection works out of the box — no setup needed. Every user authenticates their own Spotify account separately (via the in-app login), so this only identifies the app to Spotify's API, not any individual user's account. See RELEASE_VALIDATION_REPORT.md for the tradeoffs of this approach.
If you're building from source and want to use your own Spotify app instead, copy packages/electron/spotify-credentials.example.json to packages/electron/spotify-credentials.json and fill in the client ID/secret from the Spotify Developer Dashboard. This file is gitignored, so a source checkout won't have one until you create it.
This is an npm-workspaces monorepo:
interval-timer/
├── packages/
│ ├── core/ # Platform-agnostic renderer
│ │ ├── index.html / mini.html # Renderer entry points (main window / always-on-top mini window)
│ │ ├── css/styles.css
│ │ └── js/
│ │ ├── logic/ # Pure timer state machines (Timer.js, IntervalTimer.js)
│ │ ├── alarm/
│ │ │ ├── AlarmManager.js # Singleton entry point — source-agnostic
│ │ │ ├── AlarmProviderFactory.js # Detects source type, builds the right provider
│ │ │ └── providers/ # Local / YouTube / Spotify implementations
│ │ ├── views/ # DOM templates for each tab
│ │ └── renderer.js, timer.js, intervalTimer.js, mini.js, presets.js, tabs.js, ...
│ └── electron/ # Electron main process
│ ├── main.js # Windows, tray, local HTTP server, Spotify OAuth
│ ├── preload.cjs # contextBridge bridge exposing window.electronAPI
│ ├── lib/ # Main-process-only modules (presets, Spotify auth, ...)
│ ├── build/ # electron-builder assets (app icon)
│ └── spotify-credentials.json # Gitignored — see "Spotify alarms" above
└── docs/ # GitHub Pages landing page (served from /docs on main)
ISC — see the license field in package.json.
Issues and pull requests are welcome.