rin
Tiny CLI timer with desktop notification and alarm sound
Summary
| Latest Version | 0.1.0 |
|---|---|
| License | MIT |
| CI Status | Failing |
| Downloads | 0 |
| Last Indexed | 2026-07-22 05:30 |
Tags
Authors
- Carlo
Installation
nimble install rin
choosenim install rin
git clone https://github.com/capocasa/rin
OS Compatibility
| Platform | Linux | macOS | Windows | FreeBSD | OpenBSD | NetBSD | Android | iOS | WASM | Embedded |
|---|---|---|---|---|---|---|---|---|---|---|
| rin | ✓ | ✓ | ✓ | - | - | - | - | - | - | - |
Dependencies
| Package | Version | Optional |
|---|---|---|
| nim >= | 2.0.0 | No |
Source
| Repository | https://github.com/capocasa/rin |
|---|---|
| Homepage | https://github.com/capocasa/rin |
| Registry Source | nimble_official |
README
rin
A tiny CLI timer. Set a timer, get a desktop notification and alarm sound.
$ rin 5
timer set for 5m (pid 12345)
The process forks to the background and prints the PID so you can kill it if you change your mind.
Custom messages:
$ rin 10 pizza is ready
timer set for 10m (pid 12346)
How it works
- Alarm sound is baked into the binary (no external files needed)
- Notifications via D-Bus (
org.freedesktop.Notifications) - Audio playback via PulseAudio simple API
Linux only. Requires PulseAudio (or PipeWire with pulse compatibility) and a notification daemon.
Install
nimble install rin
Or build from source:
nimble build
cp rin ~/bin/
Build dependencies
- Nim >= 2.0
libpulse(PulseAudio client library)dbus-1headers (/usr/include/dbus-1.0)
On Arch: pacman -S libpulse dbus
On Debian/Ubuntu: apt install libpulse-dev libdbus-1-dev