https://github.com/andreas-glaser/quick-alarm-cinnamon
Queue alarms fast from your Cinnamon panel
https://github.com/andreas-glaser/quick-alarm-cinnamon
alarm applet cinnamon cinnamon-spices gjs javascript linux-desktop linux-mint notifications
Last synced: 15 days ago
JSON representation
Queue alarms fast from your Cinnamon panel
- Host: GitHub
- URL: https://github.com/andreas-glaser/quick-alarm-cinnamon
- Owner: andreas-glaser
- License: mit
- Created: 2025-12-15T00:04:49.000Z (3 months ago)
- Default Branch: main
- Last Pushed: 2026-01-26T00:10:12.000Z (about 2 months ago)
- Last Synced: 2026-01-26T14:50:06.134Z (about 2 months ago)
- Topics: alarm, applet, cinnamon, cinnamon-spices, gjs, javascript, linux-desktop, linux-mint, notifications
- Language: JavaScript
- Homepage: https://cinnamon-spices.linuxmint.com/applets
- Size: 918 KB
- Stars: 0
- Watchers: 1
- Forks: 0
- Open Issues: 2
-
Metadata Files:
- Readme: README.md
- Changelog: CHANGELOG.md
- License: LICENSE
Awesome Lists containing this project
README
# Quick Alarm (Cinnamon Applet)
Queue alarms fast from your Cinnamon panel. Click the applet icon, type a time, press Enter.
## Usage
1. Click the applet (alarm icon) in your panel.
2. Type an alarm time (optionally with a label).
3. Press Enter (or Ctrl+Enter to add another without closing).
### Examples
- `in 10m tea`
- `after 5m - stretch`
- `5 seconds`
- `11:59am claude`
- `claude at 11:59 am`
- `tomorrow 11:30 - reset`
### What happens when it fires
- A fullscreen overlay appears showing the time, label, and how long ago it fired.
- Plays an alarm sound.
- Click anywhere, press Escape/Enter/Space, or click Dismiss to close.
### Sleep / wake behavior
If your computer wakes after an alarm time:
- If it’s only slightly overdue, it fires immediately.
- If it’s overdue by more than a short grace window, you get a “Missed alarm” notification (no sound) and it’s removed from the queue.
## Local Install (Linux Mint / Cinnamon)
```bash
tools/install.sh
```
Restart Cinnamon (Alt+F2 → `r`), then add the applet from:
Panel Settings → Applets
## Settings
- **Show remaining time**: display countdown beside the panel icon (default: off)
- **Fullscreen notification**: show fullscreen overlay when alarm fires (default: on)
- **Alarm sound mode**: chime once, or ring for a duration
- **Ring duration**: how long "ring" mode plays sounds
- **Open shortcut**: global hotkey to open the applet menu (default: Super+Alt+A)
## Development
- Build output: `tools/build.sh` → `applet/quick-alarm@andreas-glaser/`
- Tests: `tests/run.sh` (requires `gjs`)
- Release zip: `tools/release.sh`
## Cinnamon Spices
Publishing notes: `docs/dev/release.md`