VimPlug/fzf
1
0
Fork 0
mirror of https://github.com/junegunn/fzf.git synced 2026-04-13 19:29:40 +08:00
Code Issues Actions 3 Packages Projects Releases Wiki Activity

Update README: --tmux -> --popup

Browse Source
This commit is contained in:
Junegunn Choi
2026-04-12 09:57:26 +09:00
parent f584cf38f7
commit 1b0d448c6e
1 changed files with 16 additions and 15 deletions
Download Patch File Download Diff File Expand all files Collapse all files

31
README.md
View File

@@ -62,7 +62,7 @@ Table of Contents
* [Using the finder](#using-the-finder)
* [Display modes](#display-modes)
* [`--height` mode](#--height-mode)
* [`--tmux` mode](#--tmux-mode)
* [`--popup` mode](#--popup-mode)
* [Search syntax](#search-syntax)
* [Environment variables](#environment-variables)
* [Customizing the look](#customizing-the-look)
@@ -350,23 +350,24 @@ Height value can be a negative number.
fzf --height -3
```
#### `--tmux` mode
#### `--popup` mode
With `--tmux` option, fzf will start in a tmux popup.
With `--popup` option, fzf will start in a popup window
(requires tmux 3.3+ or Zellij 0.44+).
```sh
# --tmux [center|top|bottom|left|right][,SIZE[%]][,SIZE[%][,border-native]]
# --popup [center|top|bottom|left|right][,SIZE[%]][,SIZE[%][,border-native]]
fzf --tmux center # Center, 50% width and height
fzf --tmux 80% # Center, 80% width and height
fzf --tmux 100%,50% # Center, 100% width and 50% height
fzf --tmux left,40% # Left, 40% width
fzf --tmux left,40%,90% # Left, 40% width, 90% height
fzf --tmux top,40% # Top, 40% height
fzf --tmux bottom,80%,40% # Bottom, 80% width, 40% height
fzf --popup center # Center, 50% width and height
fzf --popup 80% # Center, 80% width and height
fzf --popup 100%,50% # Center, 100% width and 50% height
fzf --popup left,40% # Left, 40% width
fzf --popup left,40%,90% # Left, 40% width, 90% height
fzf --popup top,40% # Top, 40% height
fzf --popup bottom,80%,40% # Bottom, 80% width, 40% height
```
`--tmux` is silently ignored when you're not on tmux.
`--popup` is silently ignored when you're not on tmux or Zellij.
> [!NOTE]
> If you're stuck with an old version of tmux that doesn't support popup,
@@ -378,8 +379,8 @@ fzf --tmux bottom,80%,40% # Bottom, 80% width, 40% height
> default. For example,
>
> ```sh
> # Open in tmux popup if on tmux, otherwise use --height mode
> export FZF_DEFAULT_OPTS='--height 40% --tmux bottom,40% --layout reverse --border top'
> # Open in a popup if on tmux or Zellij, otherwise use --height mode
> export FZF_DEFAULT_OPTS='--height 40% --popup bottom,40% --layout reverse --border top'
> ```
### Search syntax
@@ -566,7 +567,7 @@ the following key bindings in bash, zsh, and fish.
Display modes for these bindings can be separately configured via
`FZF_{CTRL_T,CTRL_R,ALT_C}_OPTS` or globally via `FZF_DEFAULT_OPTS`.
(e.g. `FZF_CTRL_R_OPTS='--tmux bottom,60% --height 60% --border top'`)
(e.g. `FZF_CTRL_R_OPTS='--popup bottom,60% --height 60% --border top'`)
More tips can be found on [the wiki page](https://github.com/junegunn/fzf/wiki/Configuring-shell-key-bindings).