From 75decaef057f94d7f9e9fa14c2fbf8cf78331fcf Mon Sep 17 00:00:00 2001 From: Miguel Jacq Date: Fri, 12 Dec 2025 18:00:48 -0600 Subject: [PATCH] Add Reminders (Alarms) --- Reminders-%28Alarms%29.md | 38 ++++++++++++++++++++++++++++++++++++++ 1 file changed, 38 insertions(+) create mode 100644 Reminders-%28Alarms%29.md diff --git a/Reminders-%28Alarms%29.md b/Reminders-%28Alarms%29.md new file mode 100644 index 0000000..fe5607e --- /dev/null +++ b/Reminders-%28Alarms%29.md @@ -0,0 +1,38 @@ +## Alarms/Reminders + +You can use the alarm clock button to schedule a reminder for the day. + +### Alarm Frequency + +You can choose any of the following frequencies: + + * 'Once' (one-off) alarm, + * Every day + * Every weekday (Mon-Fri) + * Every week (once a week) + * Every two weeks + * Every month (on this date of the month) + * Every month (on this day of the month e.g if today is the third Monday of December, then every month on the third Monday) + +### Alarm alerts + +When the alarm is triggered, Bouquin will reclaim focus on your screen, with a pop-up flashing a reminder based on the text you entered. + +### Webhooks + +In the Settings screen, you can optionally set a Webhook URL and a secret for sending the reminder to your webhook endpoint. For example, this could be to a Node-RED flow which then triggers a notification to, say, your phone (Signal, etc). + +The Webhook 'secret' is sent as the `X-Bouquin-Secret` header. You can use this to validate at your webhook receiver that the request came from Bouquin, so that you can reject unauthorised hits to your webhook. + +The payload is a simple JSON body with the key `reminder` and the value being the reminder text. + + +### Viewing or managing Reminders + +Use the Reminders widget in the left sidebar to view 7 days of upcoming reminders. + +You can click on the hamburger icon in that widget to manage old and upcoming reminders.From there, you can edit or delete reminders if you need to. + +Alarms that have fired and are no longer due to fire again (e.g once-only reminders) will have an 'X' symbol in the 'Active' column. Active reminders will have a tick symbol. + +You can also right-click on reminders from the widget in the sidebar to delete them, without needing to open the Manage Reminders dialog. \ No newline at end of file