temidaradev/beer
1
0
Fork 0
forked from NotAShelf/beer
Code Pull requests Activity

doc: document shell-integration, URL, notify, and bell config

Browse source 
Signed-off-by: NotAShelf <raf@notashelf.dev>
Change-Id: I75b279526ba5857d3a4104e67ccaa58e6a6a6964
This commit is contained in:
raf 2026-06-25 14:16:17 +03:00
commit 932b14bbfc
No known key found for this signature in database
GPG key ID: 29D95B64378DB4BF
2 changed files with 51 additions and 2 deletions
Download patch file Download diff file Expand all files Collapse all files

31
doc/beer.toml.5.scd
View file

@ -82,6 +82,14 @@ channel).
*visual* = _bool_
Briefly flash the screen on the terminal bell. Default _false_.
*command* = _[argv]_
Command run on the bell, e.g. _["paplay", "/usr/share/sounds/bell.oga"]_.
Unset runs nothing.
*urgent* = _bool_
Request the compositor's attention (xdg-activation) when the bell rings
while the window is unfocused. Default _false_.
# [mouse]
*scroll-multiplier* = _float_
@ -100,7 +108,8 @@ _"none"_ unbinds the chord.
Recognized actions: _copy_, _paste_, _paste-primary_, _scrollback-up_,
_scrollback-down_, _scrollback-top_, _scrollback-bottom_, _search_,
_font-increase_, _font-decrease_, _font-reset_, _fullscreen_.
_font-increase_, _font-decrease_, _font-reset_, _fullscreen_, _new-window_,
_jump-prompt-up_, _jump-prompt-down_, _pipe-command-output_, _url-mode_.
```
[key-bindings]
@ -108,6 +117,26 @@ _font-increase_, _font-decrease_, _font-reset_, _fullscreen_.
"Ctrl+grave" = "none"
```
# [shell-integration]
Behaviour driven by *OSC 7* (cwd) and *OSC 133* (prompt) marks.
*pipe-command* = _[argv]_
Command the _pipe-command-output_ binding feeds the last command's output
to on stdin, e.g. _["less"]_. Empty (the default) disables the action.
# [url]
*launch* = _[argv]_
Launcher the URL is appended to when an _OSC 8_ hyperlink is clicked or a
hint-mode label is chosen. Default _["xdg-open"]_.
# [notify]
*command* = _[argv]_
Notifier for desktop notifications (_OSC 9_/_777_/_99_); the title and body
are appended as the final two arguments. Default _["notify-send"]_.
# [text-bindings]
A table of _chord_ = _text_ entries that send a literal string to the shell.