aboutsummaryrefslogtreecommitdiff
path: root/notify.h
diff options
context:
space:
mode:
authorDaniel Eklöf <daniel@ekloef.se>2024-07-23 09:29:05 +0000
committerDaniel Eklöf <daniel@ekloef.se>2024-07-23 09:29:05 +0000
commitccb184ae645cd92a6e3aba429ab88a94a09bbf8c (patch)
tree881797b5589ff9fbb7588b24791014ab01813fad /notify.h
parentnotify: stdout is a bad name (diff)
osc: kitty notifications: updated support for icons
This implements the suggested protocol discussed in https://github.com/kovidgoyal/kitty/issues/7657. Icons are handled by loading a cache. Both in-band PNG data, and symbolic names are allowed. Applications use a graphical ID to reference the icon both when loading the cache, and when showing a notification. * 'g' is the graphical ID * 'n' is optional, and assigns a symbolic name to the icon * 'p=icon' - the payload is icon PNG data. It needs to be base64 encoded, but this is *not* implied. I.e. the application *must* use e=1 explicitly. To load an icon (in-band PNG data): printf '\e]99;g=123:p=icon;<base64-encoded-png-data>\e\\' or (symbolic name) printf '\e]99;g=123:n=firefox:p=icon;\e\\' Of course, we can combine the two, assigning *both* a symbolic name, *and* PNG data: printf '\e]99;g=123:n=firefox:p=icon;<base64-encoded-png>\e\\' Then, to use the icon in a notification: printf '\e]99;g=123;this is a notification\e\\' Foot also allows a *symbolic* icon to be defined and used at the same time: printf '\e]99;g=123:n=firefox;this is a notification\e\\' This obviously won't work with PNG data, since it uses the payload portion of the escape sequence.
Diffstat (limited to 'notify.h')
-rw-r--r--notify.h19
1 files changed, 18 insertions, 1 deletions
diff --git a/notify.h b/notify.h
index ec62e03e..55ace52d 100644
--- a/notify.h
+++ b/notify.h
@@ -1,5 +1,6 @@
#pragma once
#include <stdbool.h>
+#include <stdint.h>
#include <unistd.h>
struct terminal;
@@ -29,7 +30,11 @@ struct notification {
char *id;
char *title;
char *body;
- char *icon;
+
+ char *icon_id;
+ char *icon_symbolic_name;
+ uint8_t *icon_data;
+ size_t icon_data_sz;
enum notify_when when;
enum notify_urgency urgency;
@@ -49,5 +54,17 @@ struct notification {
size_t stdout_sz;
};
+struct notification_icon {
+ char *id;
+ char *symbolic_name;
+ char *tmp_file_on_disk;
+};
+
bool notify_notify(const struct terminal *term, struct notification *notif);
void notify_free(struct terminal *term, struct notification *notif);
+
+void notify_icon_add(struct terminal *term, const char *id,
+ const char *symbolic_name, const uint8_t *data,
+ size_t data_sz);
+void notify_icon_del(struct terminal *term, const char *id);
+void notify_icon_free(struct notification_icon *icon);