aboutsummaryrefslogtreecommitdiff
diff options
context:
space:
mode:
authorDaniel Eklöf <daniel@ekloef.se>2022-12-08 10:50:43 +0000
committerDaniel Eklöf <daniel@ekloef.se>2024-02-06 11:12:57 +0000
commit0fed2451eae01922c8fcbb40ab35b32ac3d655a9 (patch)
tree496ce74245b0cedf80037b07edd2e8fb5f0fc699
parentfoot.ini: add pipe-command-output key binding (diff)
doc: foot.ini: document pipe-command-output
-rw-r--r--doc/foot.ini.5.scd22
1 files changed, 15 insertions, 7 deletions
diff --git a/doc/foot.ini.5.scd b/doc/foot.ini.5.scd
index 1c87db53..14999a8b 100644
--- a/doc/foot.ini.5.scd
+++ b/doc/foot.ini.5.scd
@@ -844,11 +844,12 @@ e.g. *search-start=none*.
*fullscreen*
Toggles the fullscreen state. Default: _none_.
-*pipe-visible*, *pipe-scrollback*, *pipe-selected*
- Pipes the currently visible text, the entire scrollback, or the
- currently selected text to an external tool. The syntax for this
- option is a bit special; the first part of the value is the
- command to execute enclosed in "[]", followed by the binding(s).
+*pipe-visible*, *pipe-scrollback*, *pipe-selected*, *pipe-command-output*
+ Pipes the currently visible text, the entire scrollback, the
+ currently selected text, or the last command's output to an
+ external tool. The syntax for this option is a bit special; the
+ first part of the value is the command to execute enclosed in
+ "[]", followed by the binding(s).
You can configure multiple pipes as long as the command strings
are different and the key bindings are unique.
@@ -856,10 +857,17 @@ e.g. *search-start=none*.
Note that the command is *not* automatically run inside a shell;
use *sh -c "command line"* if you need that.
- Example:
- *pipe-visible=[sh -c "xurls | uniq | tac | fuzzel | xargs -r
+ Example #1:
+
+ # Extract currently visible URLs, let user choose one (via
+ fuzzel), then launch firefox with the selected URL++
+*pipe-visible=[sh -c "xurls | uniq | tac | fuzzel | xargs -r
firefox"] Control+Print*
+ Example #2:
+ # Write scrollback content to /tmp/foot-scrollback.txt++
+*pipe-scrollback=[sh -c "cat - > /tmp/foot-scrollback.txt"]
+ Control+Shift+Print*
Default: _none_
*show-urls-launch*