Digital Detox
A small Windows app that locks your screen for a set amount of time, so you actually take that break.

Features
- Pick a duration from 1 to 999 minutes, or use the quick presets (5, 15, 25, 45, 60 min), and see right away when it will end
- Pomodoro mode: 25 minutes of focus with the PC free, then the screen locks for a 5-minute break (15 minutes after every 4th round). A small reminder appears in the corner a minute before each break, and the tray icon shows how long is left
- Sync your devices: pair your PC and laptop once with a 6-digit code, and a detox or a Pomodoro started on one starts on the other too, with the breaks locking both at the same moment. It works on your local network only, with no account or server
- Full-screen lock that stays on top until the timer ends, with a countdown, progress bar and unlock time
- The screen switches off gradually: it dims as soon as the detox starts (on laptops the brightness drops to the minimum), turns black after three minutes without input, and on desktop PCs the monitor is switched off a couple of minutes later. Press +5 minutes to keep it on for longer, move the mouse to see the timer again, or press Turn off screen to go dark right away. Everything comes back at the end.
- Breathing guide: a circle above the timer grows and shrinks between two fixed rings at the pace of Buteyko's reduced breathing (2 s in, 3 s out, 4 s pause). It moves at a steady speed, so you can tell how long each breath will last
- No pauses: the PC is kept from going to sleep until the detox is over
- All monitors covered: secondary screens get their own overlay with the timer
- Shortcuts blocked while locked: Windows key, Alt+Tab, Alt+F4, Alt+Esc, Ctrl+Esc and Ctrl+Shift+Esc. The taskbar is hidden on every monitor, and the Start menu is closed right away if it opens
- A calming message picked at random for each session
- Unlocks automatically when the time is up
- Emergency exit if you really need your computer back
- Lives in the system tray: closing or minimizing the window keeps the app in the system tray. Left-click the tray icon to open it, right-click the tray icon to start a detox or a Pomodoro right away, turn syncing on or off, or quit
- Start with Windows (optional): choose it during installation or tick it in the tray menu, and the app starts at sign-in, quietly in the system tray
- Lightweight: a single ~12 MB executable that uses about 5 MB of memory, no administrator rights needed
Download
From the Releases page, pick one:
- Installer (
DigitalDetox-vX.Y.Z-setup-x64.exe): adds Digital Detox to the Start menu, optionally to the desktop, and to Windows' list of installed apps for easy removal. No administrator rights needed.
- Portable (
DigitalDetox-vX.Y.Z-win-x64.zip): unzip it anywhere and run DigitalDetox.exe. Nothing else to install.
- Android preview (
DigitalDetox-vX.Y.Z-android-arm64.apk): for Android 11 or later. Open the file on your phone and allow installing from that source when Android asks; android/README.md explains the permissions it needs. It syncs with the Windows app like a second PC.
Since the files aren't code-signed, Windows SmartScreen may warn you the first time: click More info → Run anyway.
Build from source
Requires Windows 10 or 11, Rust (stable) and the Visual Studio C++ Build Tools (the Rust installer offers to install them).
git clone https://github.com/telcoray/DigitalDetox.git
cd DigitalDetox
cargo run
To create an optimized build (target/release/digital-detox.exe):
cargo build --release
The UI is drawn by Slint's software renderer, which keeps memory usage very low. To try the GPU-based Skia renderer instead (bigger executable, more memory, needs the Visual Studio 2022 C++ Build Tools):
cargo run --no-default-features --features skia
Project layout
ui/ Slint files describing the windows (main window, lock screen, secondary monitors)
src/
main.rs app start-up and main window
session.rs one detox session: lock screen, timer, monitors, emergency exit
pomodoro.rs the Pomodoro cycle of work rounds and breaks
reminder.rs the "Break in 1 minute" card
sharing.rs what to do when a paired device starts or stops something
sync/ pairing and talking to paired devices on the local network
keyboard_hook.rs blocking of system shortcuts
single_instance.rs only one copy of the app at a time
assets/ logo and icon
android/ preview of the Android app (see android/README.md)
How to use
- Enter how many minutes you want to disconnect, or click a preset
- Click Start detox (or press Enter)
- Step away from the screen; it unlocks by itself when the timer reaches zero
Pomodoro
Open the Pomodoro tab and click Start Pomodoro:
- Work for 25 minutes with your PC free
- A minute before the break, a small reminder appears in the corner so you can save your work
- The screen locks for a 5-minute break, then the next round starts by itself. Every 4th break lasts 15 minutes
It keeps going round after round until you click Stop, here or in the tray menu. Pause freezes the countdown until you click Resume.
Sync with your other devices
- Install Digital Detox on both devices, connected to the same network
- On one, open the Sync tab and click Pair a device: it shows a 6-digit code
- On the other, click Enter a code, type it and click Pair
From then on, a detox or a Pomodoro started on either device starts on both, and Stop Pomodoro stops both. A device that was asleep or switched off catches up when it's back. Turn Sync with paired devices off on a device to leave it out for a while.
The code itself never travels over the network, and everything the devices send each other is signed with a key only they have. The first time, Windows Firewall asks to let Digital Detox use the network: allow it on private networks. The emergency exit unlocks only the device it's used on.
Emergency exit
Press Ctrl+Shift+X three times in a row (within 2 seconds of each other). An Emergency Exit button appears; click it and confirm to end the session early.
Limitations
Digital Detox is meant to help you keep a commitment, not to be an unbreakable lock. Ctrl+Alt+Del is handled by Windows itself and can't be blocked by any application, so it is always possible to sign out, lock or restart the PC.
History
Version 2 is a rewrite in Rust with Slint. Version 1 was written in C# with WPF on .NET; its code is still available at the v1.0.1 tag.
License
MIT