BreakTimer
Desktop app that manages and enforces periodic computer breaks.
Tested on macOSKnown vulnerabilities
What it does
- Set how long and how often breaks areTested
How to use it
- Open the BreakTimer Settings window and go to the Breaks section.
- Change the break length with the slider or number field, for example to <minutes>.
- Get reminders as a notification or a fullscreen windowTested
How to use it
- Open the BreakTimer Settings window.
- Find the option for how breaks are announced.
- Choose Notification for a simple notification, or the fullscreen popup window.
- Limit reminders to your working hoursTested
How to use it
- Click the BreakTimer icon in the menu bar and choose Settings.
- Go to the Working Hours section.
- Use the Enabled toggle at the top to turn Working Hours on or off.
- Change the message shown during breaksTested
How to use it
- Open the BreakTimer Settings window.
- Find the break message text field.
- Clear it and type <your text>.
Use it
Before you install: known vulnerabilities
pickfit found 1 known high or critical vulnerability in the packages a fresh install brings (OSV.dev, 3 Nov 2026). Weigh this before you install it.
npm:source-map-js 1.2.1source-map-js allows event-loop denial of service through indexed source-map section offsets (GHSA-68fv-2mgg-jv7q, high, fixed in 1.2.2)
macOS arm64
Install BreakTimer cask to ~/Applications
mkdir -p ~/Applications && brew install --cask --appdir=$HOME/Applications breaktimer
Open BreakTimer from Applications; it runs from the menu bar, where you click its icon and choose Settings to open the full Settings window.
How far pickfit got
macOS arm64
- Installs
- Opens to its setup screen
- 4 of 4 features work
- Works offline
Linux and Windows: the project says it runs there; pickfit hasn’t tried it.
How pickfit tested it
Each run starts from a clean machine and follows the steps above. How pickfit verifies
macOS arm64
A feature worked when operated
- Replayed from scratch
- Checked on 1 Nov 2026
- Version 2.0.3
When pickfit opened it, its first-run (setup) screen rendered. pickfit then used it, and this worked: Change the message shown during breaks; Set how long and how often breaks are; Get reminders as a notification or a fullscreen window; Limit reminders to your working hours. The launch passed again with the network off.
The clip was cut from these unedited recordings:
- Change the message shown during breaks (45 s)
- Set how long and how often breaks are (40 s)
- Get reminders as a notification or a fullscreen window (97 s)
Differences the test machine hit
- README: macOS - BreakTimer.dmg download
In the test: brew install --cask --appdir=$HOME/Applications breaktimer (sbx cannot write /Applications; same 2.0.3 app, links /opt/homebrew/bin/breaktimer) - README: breaktimer disable / breaktimer enable
In the test: On macOS do not run /opt/homebrew/bin/breaktimer headless (Electron FATAL: Unable to find helper app); start with open ~/Applications/BreakTimer.app and use Settings UI. README CLI disable/enable is Linux-only per FAQ.