A tiny system tray utility that helps you track time effortlessly with countdowns ⏱️ and stopwatches ⏲️ — complete with native desktop notifications 🎉.
- 🖥️ Supported-platform: Linux.
- 🔔 Native notifications: Uses OS-specific tools (like
notify-send,kdialog) for alerts. - 🔁 Reset, pause, and resume: Right-click tray menu to control the timer.
- 📌 Modes:
- Countdown ⏳
- Stopwatch ⏱️
traytimer.webm
Download the binary, extract it, and run:
chmod +x traytimer
./traytimer --duration 15mwget https://github.com/intekhabrizvi/traytimer/releases/download/v1.0.0/traytimer_1.0.0_amd64.deb
sudo apt install ./traytimer_1.0.0_amd64.debThen launch with:
traytimer --duration 15mtraytimer --duration 15mtraytimer --mode stopwatchUse setsid for CLI:
setsid traytimer --duration 15m &Or launch it from the application menu if installed via .deb.
| Flag | Description | Default |
|---|---|---|
--duration |
Duration for countdown (e.g. 5m, 90s) |
15m |
--mode |
Clock mode: timer, stopwatch |
timer |
▶️ Pause / Resume- 🔁 Reset
- ⏲️ 5min / 15min / 30min / 45min / 60min / 90min / 120min shortcuts
- 🚪 Quit
If you don’t already have Go installed:
sudo apt install golang-go # UbuntuOr visit golang.org
git clone https://github.com/intekhabrizvi/traytimer.git
cd traytimersudo apt-get install gcc libgtk-3-dev libayatana-appindicator3-devgo build -o traytimer .You should now see the traytimer binary in the current directory.
We ❤️ contributions! Here's how to help:
git clone https://github.com/intekhabrizvi/traytimer.git
cd traytimergit checkout -b feature/my-improvementgit add .
git commit -m "Added awesome feature"git push origin feature/my-improvementThen open a Pull Request on GitHub 🚀
Use fpm or rpmbuild to package:
fpm -s dir -t rpm -n traytimer -v 1.0.0 traytimer=/usr/local/bin/traytimerMIT License © Intekhab rizvi
Found a bug? Want a new feature? Open an issue or start a discussion!
✨ Happy timing!