https://github.com/skvggor/break-reminder
⏱️ Periodic desktop notifications with sound via systemd user timer.
https://github.com/skvggor/break-reminder
bash desktop-notifications linux notify-send productivity reminder shell systemd-timer
Last synced: about 20 hours ago
JSON representation
⏱️ Periodic desktop notifications with sound via systemd user timer.
- Host: GitHub
- URL: https://github.com/skvggor/break-reminder
- Owner: skvggor
- License: gpl-3.0
- Created: 2026-03-05T15:21:20.000Z (4 months ago)
- Default Branch: main
- Last Pushed: 2026-03-26T19:15:20.000Z (3 months ago)
- Last Synced: 2026-03-27T08:13:24.641Z (3 months ago)
- Topics: bash, desktop-notifications, linux, notify-send, productivity, reminder, shell, systemd-timer
- Language: Shell
- Homepage: https://break-reminder.reposito.rio.br/
- Size: 101 KB
- Stars: 1
- Watchers: 0
- Forks: 0
- Open Issues: 0
-
Metadata Files:
- Readme: README.md
- License: LICENSE
Awesome Lists containing this project
README
break-reminder
Periodic desktop notifications with sound via systemd user timer.
Edit `break-reminder.sh` to customize messages and `break-reminder.timer` to change the interval (`OnBootSec` / `OnUnitActiveSec`).
## Features
- Desktop notification with critical urgency (stays visible until dismissed)
- Sound plays 3 times with 3-second interval
- Multiple sound backends: paplay → ffplay → canberra-gtk-play → speaker-test
- Debug mode to troubleshoot sound issues
## Install
```bash
./install.sh
```
## Uninstall
```bash
./uninstall.sh
```
## Commands
```bash
# Check timer status
systemctl --user status break-reminder.timer
# See next trigger time
systemctl --user list-timers break-reminder.timer
# Test notification manually
./break-reminder.sh
# Test with debug output
./break-reminder.sh --debug
# Stop temporarily
systemctl --user stop break-reminder.timer
# Restart
systemctl --user start break-reminder.timer
```
## License
[GNU GPLv3](LICENSE)