From 729f7466ae6ed7a4bd51b27999ddc50c43a27d89 Mon Sep 17 00:00:00 2001 From: Mitja Horvat Date: Tue, 5 Oct 2021 23:07:01 +0200 Subject: notify: add the notify-focus-inhibit config option foot doesn't show desktop notifications (via OSC777) if the current terminal has keyboard focus. This is probably a sane default, but there are use cases where showing a notification regardless of the focus status may be desired. For example, a completion notification of a long running task inside a non-focused tmux window. This PR adds the notify-focus-inhibit option which can be used to disable inhibition of notifications when the window has focus. The default value is `yes`, which retains the old behavior. --- doc/foot.ini.5.scd | 16 ++++++++++++---- 1 file changed, 12 insertions(+), 4 deletions(-) (limited to 'doc') diff --git a/doc/foot.ini.5.scd b/doc/foot.ini.5.scd index 6bc93cc4..26116d62 100644 --- a/doc/foot.ini.5.scd +++ b/doc/foot.ini.5.scd @@ -279,11 +279,17 @@ in this order: - OSC 777: *\\e]777;notify;;<body>\\e\\\\* - Notifications are *inhibited* if the foot window has keyboard - focus. + By default, notifications are *inhibited* if the foot window + has keyboard focus. See _notify-focus-inhibit_. Default: _notify-send -a ${app-id} -i ${app-id} ${title} ${body}_. +*notify-focus-inhibit* + Boolean. If enabled, foot will not display notifications if the + terminal window has keyboard focus. + + Default: _yes_ + *selection-target* Clipboard target to automatically copy selected text to. One of *none*, *primary*, *clipboard* or *both*. Default: _primary_. @@ -316,8 +322,10 @@ in this order: *notify* When set to _yes_, foot will emit a desktop notification using the command specified in the *notify* option whenever *BEL* is - received and the window does *not* have keyboard focus. Default: - _no_ + received. By default, bell notifications are shown only when the + window does *not* have keyboard focus. See _notify-focus-inhibit_. + + Default: _no_ *command* When set, foot will execute this command when *BEL* is received. -- cgit v1.3