What's new
Breaking changes
Change unit of flash speed to bpm (beats per minute)
Previously, the flash speed was not quantized and was displayed only as "slow," "fast," etc. To help users better understand how fast the flash is, we now use BPM (beats per minute) as the unit for flash speed. The default is 120 BPM. If you have previously adjusted the setting, you may need to re-calibrate it, as the old internal unit was approximately 20% faster than the new unit.
Related commit:
- use bpm as unit for flash speed (b2b09f0)
Custom messages now only shows in full-screen mode
Custom messages can sometimes be too long for the small flashing prompt. To maintain a clean UI, we now show custom messages only in full-screen mode, while the prompt continues to use the default "Time for a small/big break" message.
Related commit:
- only show custom messages in full-screen (ce271c5)
Features
More controls over break UI
Sane Break v0.9.0
introduces even greater flexibility in the break UI. You can now choose which components to display in the break window and preview your custom layout with a single click:

In addition to the classic countdown and progress bar, you can create a more immersive experience by hiding the countdown and progress bar, and showing only the clock and the time when the break will end. You can also uncheck "Close window right after break ends" in the Reminder tab, so the break window stays open after the break. With these settings, the app gently encourages you to step away and return only when you're ready.

Related commits:
- enable immersive break experience (7973207)
- preview button for break window interface setting (6cc5324)
Other Features
- avoid starting more than one instance of the app (409f8cb, 659dffe)
- button to revert preferences to default values (bdc54b2)
Changes
- organize preference tabs and add "Interface" tab (9fe7eab)
- separate Wayland and X11 deps with plugins (be1b9cf)
- add AppImage build (e508d71, 39ba7f3)
- document Copr package (22a72bb)
- adopt state machine pattern for app logic (38435c7)
Bug fixes
- fix SIGSEGV in Wayland idle after quitting app (882dcc9)
- remove unused macOS permission hint (14b36ed)
Installation instructions:
Download Download the For Debian-based distributions, there is a notoriously large number of derivatives, and many of them ship old versions of Qt and do not include the latest AppImage version is experimental. It may or may not work on your machine.
macOS
sane-break-macos-x86_64.dmg
file if you are using Intel mac, or sane-break-macos-arm64.dmg
if you are using ARM chip. Open and install it. macOS 13 or newer are supported.
Windows
sane-break-windows.zip
extract it. Put the .exe
executable anywhere you like. x86 version of Windows 10 or newer is supported. Older versions may be supported too.
Linux
layer-shell-qt
. It is impractical to create .deb
packages for all of them, so we only provide support for Debian Bookworm and Trixie. (Unfortunately, Ubuntu LTS ships with a very old version of Qt and lacks layer-shell-qt
.)
The difference between Bookworm build and Trixie build is the layer shell support. If you are using a Debian-based distro and a Wayland compositor with layer shell protocol support (e.g. KDE Neon), you probably need the Debian Trixie build. Otherwise, the Bookworm build is good to go.
For GNOME users, make sure to enable the GNOME shell extension with:
gnome-extensions enable sane-break@allanchain.github.io