diff options
| author | Junegunn Choi <junegunn.c@gmail.com> | 2023-10-09 01:29:03 +0900 |
|---|---|---|
| committer | Junegunn Choi <junegunn.c@gmail.com> | 2023-10-09 01:29:03 +0900 |
| commit | 2952737755aeda4c088a84693569f7b881162160 (patch) | |
| tree | 93ea56195698123d2b284060e45406cc9a7186dc | |
| parent | f103aa4753b435f8f45c5130323effeb75583c15 (diff) | |
Update README: Experimental support for Kitty graphics protocol
| -rw-r--r-- | CHANGELOG.md | 2 | ||||
| -rw-r--r-- | README.md | 17 | ||||
| -rw-r--r-- | man/man1/fzf.1 | 12 |
3 files changed, 30 insertions, 1 deletions
diff --git a/CHANGELOG.md b/CHANGELOG.md index 3614beb5..e2c51a4a 100644 --- a/CHANGELOG.md +++ b/CHANGELOG.md @@ -6,7 +6,7 @@ CHANGELOG - Experimental, partial support for Kitty image protocol in the preview window ```sh fzf --preview=' - if file --mime-type {} | grep -qF 'image/'; then + if file --mime-type {} | grep -qF image/; then # --transfer-mode=memory is the fastest option but if you want fzf to be able # to redraw the image on terminal resize or on 'change-preview-window', # you need to use --transfer-mode=stream. @@ -69,6 +69,7 @@ Table of Contents * [2. Switch between sources by pressing CTRL-D or CTRL-F](#2-switch-between-sources-by-pressing-ctrl-d-or-ctrl-f) * [3. Interactive ripgrep integration](#3-interactive-ripgrep-integration) * [Preview window](#preview-window) + * [Previewing an image](#previewing-an-image) * [Tips](#tips) * [Respecting `.gitignore`](#respecting-gitignore) * [Fish shell](#fish-shell) @@ -730,6 +731,22 @@ seq 100 | fzf history | fzf ``` +### Previewing an image + +Since 0.43.0, fzf has experimental support for [Kitty graphics +protocol](https://sw.kovidgoyal.net/kitty/graphics-protocol/), so if you use +Kitty, you can make fzf display an image in the preview window. + +```sh +fzf --preview=' + if file --mime-type {} | grep -qF image/; then + kitty icat --clear --transfer-mode=memory --stdin=no --place=${FZF_PREVIEW_COLUMNS}x${FZF_PREVIEW_LINES}@0x0 {} + else + bat --color=always {} + fi +' +``` + Tips ---- diff --git a/man/man1/fzf.1 b/man/man1/fzf.1 index 4388c97b..28a772ea 100644 --- a/man/man1/fzf.1 +++ b/man/man1/fzf.1 @@ -591,6 +591,18 @@ e.g. echo "$i" sleep 0.01 done'\fR + +Since 0.43.0, fzf has experimental support for Kitty graphics protocol, +so if you use Kitty, you can make fzf display an image in the preview window. + +e.g. + \fBfzf --preview=' + if file --mime-type {} | grep -qF "image/"; then + kitty icat --clear --transfer-mode=memory --stdin=no --place=${FZF_PREVIEW_COLUMNS}x${FZF_PREVIEW_LINES}@0x0 {} + else + bat --color=always {} + fi + '\fR .RE .TP |