diff options
| author | Daniel Eklöf <daniel@ekloef.se> | 2020-12-08 18:19:55 +0000 |
|---|---|---|
| committer | Daniel Eklöf <daniel@ekloef.se> | 2020-12-09 19:54:51 +0000 |
| commit | 21cc68d49e94f3a385afc2bf59c5f7d88f9ad802 (patch) | |
| tree | 99da4f60f825073c2ff9ac2ee69fb9a06e7394b5 /doc | |
| parent | Merge branch 'remove-deprecated-things' (diff) | |
osc: implement urxvt’s “OSC 777;notify”
OSC 777 is URxvt’s generic escape to send commands to its perl
extensions. The first parameter is the name of the extension, followed
by its arguments.
OSC 777;notify is a, if not well established, at least a fairly well
known escape sequence to request a (desktop) notification. The syntax
is:
\e]777;notify;<title>;<body>\e\\
Neither title nor body is escaped in any way, meaning they should not
contain a ‘;’.
Foot will split title from body at the *first* ‘;’. Any remaining ‘;’
characters are treated as part of ‘body’.
Instead of adding built-in support for the freedesktop notification
specification (which would require us to link against at least dbus),
add a new config option to foot.ini: ‘notify’.
This option specifies the command to execute when a notification is
received. ‘${title}’ and ‘${body}’ can be used anywhere, in any
combination, and as many times as you want, in any of the command
arguments.
The default value is ‘notify-send -a foot -i foot ${title} ${body}’
Diffstat (limited to 'doc')
| -rw-r--r-- | doc/foot.ini.5.scd | 11 |
1 files changed, 11 insertions, 0 deletions
diff --git a/doc/foot.ini.5.scd b/doc/foot.ini.5.scd index 14cd6d16..9c3430cd 100644 --- a/doc/foot.ini.5.scd +++ b/doc/foot.ini.5.scd @@ -145,6 +145,17 @@ in this order: text. Note that whitespace characters are _always_ word delimiters, regardless of this setting. Default: _,│`|:"'()[]{}<>_ +*notify* + Command to execute to display a notification. _${title}_ and + _${body}_ will be replaced with the notification's actual _title_ + and _body_ (message content). + + Applications can trigger notifications in the following ways: + + - OSC 777: *\\e]777;notify;<title>;<body>\\e\\\\* + + Default: _notify-send -a foot -i foot ${title} ${body}_. + # SECTION: scrollback |
