aboutsummaryrefslogtreecommitdiff
path: root/notify.h
diff options
context:
space:
mode:
authorDaniel Eklöf <daniel@ekloef.se>2024-07-19 13:04:28 +0000
committerDaniel Eklöf <daniel@ekloef.se>2024-07-23 05:17:21 +0000
commitb0bf8ca5f7034f6d95bc3b58082e719a81d99859 (patch)
tree038d7f081038f8c71a98e93e5c31dcad874ff9fc /notify.h
parentinput: allow mouse selections to start inside the margins (diff)
osc/notify: add support for OSC-99, kitty desktop notifications
This adds limited support for OSC-99, kitty desktop notifications[^1]. We support everything defined by the "protocol", except: * 'a': action to perform on notification activation. Since we don't trigger the notification ourselves (over D-Bus), we don't know a) which ID the notification got, or b) when it is clicked. * ... and that's it. Everything else is supported To be explicit, we *do* support: * Chunked notifications (d=0|1), allowing the application to append data to a notification in chunks, before it's finally displayed. * Plain UTF-8, or base64-encoded UTF-8 payload (e=0|1). * Notification identifier (i=xyz). * Payload type (p=title|body). * When to honor the notification (o=always|unfocused|invisible), with the following quirks: - we don't know when the window is invisible, thus it's treated as 'unfocused'. - the foot option 'notify-focus-inhibit' overrides 'always' * Urgency (u=0|1|2) [^1]: https://sw.kovidgoyal.net/kitty/desktop-notifications/
Diffstat (limited to 'notify.h')
-rw-r--r--notify.h28
1 files changed, 26 insertions, 2 deletions
diff --git a/notify.h b/notify.h
index ce60562f..be79b41a 100644
--- a/notify.h
+++ b/notify.h
@@ -1,6 +1,30 @@
#pragma once
+#include <stdbool.h>
-#include "terminal.h"
+struct terminal;
+
+enum notify_when {
+ NOTIFY_ALWAYS,
+ NOTIFY_UNFOCUSED,
+ NOTIFY_INVISIBLE
+};
+
+enum notify_urgency {
+ NOTIFY_URGENCY_LOW,
+ NOTIFY_URGENCY_NORMAL,
+ NOTIFY_URGENCY_CRITICAL,
+};
+
+struct kitty_notification {
+ char *id;
+ char *title;
+ char *body;
+ enum notify_when when;
+ enum notify_urgency urgency;
+ bool focus;
+ bool report;
+};
void notify_notify(
- const struct terminal *term, const char *title, const char *body);
+ const struct terminal *term, const char *title, const char *body,
+ enum notify_when when, enum notify_urgency urgency);