aboutsummaryrefslogtreecommitdiff
path: root/README.md
diff options
context:
space:
mode:
authorDaniel Eklöf <daniel@ekloef.se>2021-02-08 09:06:13 +0000
committerDaniel Eklöf <daniel@ekloef.se>2021-02-08 09:06:13 +0000
commit63a50afc8e7d2b315e896f4469112f4240a1592e (patch)
tree99429f79b9df9436dcb4454c7dbd05402e03e727 /README.md
parentMerge branch 'xassert-performance-regression-2' (diff)
parenturl-mode: urls_render(): early exit when URL list is empty (diff)
Merge branch 'url-detection'
Diffstat (limited to 'README.md')
-rw-r--r--README.md34
1 files changed, 33 insertions, 1 deletions
diff --git a/README.md b/README.md
index e55d3e82..428d4958 100644
--- a/README.md
+++ b/README.md
@@ -22,6 +22,7 @@ The fast, lightweight and minimalistic Wayland terminal emulator.
1. [Scrollback search](#scrollback-search)
1. [Mouse](#mouse)
1. [Server (daemon) mode](#server-daemon-mode)
+1. [URLs](#urls)
1. [Alt/meta](#alt-meta)
1. [Backspace](#backspace)
1. [Keypad](#keypad)
@@ -43,12 +44,13 @@ The fast, lightweight and minimalistic Wayland terminal emulator.
* Lightweight, in dependencies, on-disk and in-memory
* Wayland native
* DE agnostic
+* Server/daemon mode
* User configurable font fallback
* On-the-fly font resize
* On-the-fly DPI font size adjustment
* Scrollback search
+* Keyboard driven URL detection
* Color emoji support
-* Server/daemon mode
* IME (via `text-input-v3`)
* Multi-seat
* [Synchronized Updates](https://gitlab.freedesktop.org/terminal-wg/specifications/-/merge_requests/2) support
@@ -154,6 +156,10 @@ These are the default shortcuts. See `man foot.ini` and the example
sequence](https://codeberg.org/dnkl/foot/wiki#user-content-how-to-configure-my-shell-to-emit-the-osc-7-escape-sequence),
the new terminal will start in the current working directory.
+<kbd>ctrl</kbd>+<kbd>shift</kbd>+<kbd>u</kbd>
+: Enter URL mode, where all currently visible URLs are tagged with a
+ jump label with a key sequence that will open the URL.
+
#### Scrollback search
@@ -247,6 +253,32 @@ desktop), and then run `footclient` instead of `foot` whenever you
want to launch a new terminal.
+## URLs
+
+Foot supports URL detection. But, unlike many other terminal
+emulators, where URLs are highlighted when they are hovered and opened
+by clicking on them, foot uses a keyboard driven approach.
+
+Pressing <kbd>ctrl</kbd>+<kbd>shift</kbd>+<kbd>u</kbd> enters _“URL
+mode”_, where all currently visible URLs are underlined, and is
+associated with a _“jump-label”_. The jump-label indicates the _key
+sequence_ (e.g. **”AF”**) to use to activate the URL.
+
+The key binding can, of course, be customized, like all other key
+bindings in foot. See `show-urls-launch` and `show-urls-copy` in the
+`foot.ini` man page.
+
+`show-urls-launch` by default opens the URL with `xdg-open`. This can
+be changed with the `url-launch` option.
+
+`show-urls-copy` is an alternative to `show-urls-launch`, that changes
+what activating an URL _does_; instead of opening it, it copies it to
+the clipboard. It is unbound by default.
+
+Both the jump label colors, and the URL underline color can be
+configured, independently.
+
+
## Alt/meta
By default, foot prefixes _Meta characters_ with ESC. This corresponds