VimPlug/fzf
1
0
Fork 0
mirror of https://github.com/junegunn/fzf.git synced 2026-08-02 14:10:32 +08:00
Code Issues Actions 1 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
README.md
+16 -15
View File
@@ -62,7 +62,7 @@ Table of Contents
* [Using the finder](#using-the-finder) * [Using the finder](#using-the-finder)
* [Display modes](#display-modes) * [Display modes](#display-modes)
* [`--height` mode](#--height-mode) * [`--height` mode](#--height-mode)
* [`--tmux` mode](#--tmux-mode) * [`--popup` mode](#--popup-mode)
* [Search syntax](#search-syntax) * [Search syntax](#search-syntax)
* [Environment variables](#environment-variables) * [Environment variables](#environment-variables)
* [Customizing the look](#customizing-the-look) * [Customizing the look](#customizing-the-look)
@@ -350,23 +350,24 @@ Height value can be a negative number.
fzf --height -3 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 ```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 --popup center # Center, 50% width and height
fzf --tmux 80% # Center, 80% width and height fzf --popup 80% # Center, 80% width and height
fzf --tmux 100%,50% # Center, 100% width and 50% height fzf --popup 100%,50% # Center, 100% width and 50% height
fzf --tmux left,40% # Left, 40% width fzf --popup left,40% # Left, 40% width
fzf --tmux left,40%,90% # Left, 40% width, 90% height fzf --popup left,40%,90% # Left, 40% width, 90% height
fzf --tmux top,40% # Top, 40% height fzf --popup top,40% # Top, 40% height
fzf --tmux bottom,80%,40% # Bottom, 80% width, 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] > [!NOTE]
> If you're stuck with an old version of tmux that doesn't support popup, > 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, > default. For example,
> >
> ```sh > ```sh
> # Open in tmux popup if on tmux, otherwise use --height mode > # Open in a popup if on tmux or Zellij, otherwise use --height mode
> export FZF_DEFAULT_OPTS='--height 40% --tmux bottom,40% --layout reverse --border top' > export FZF_DEFAULT_OPTS='--height 40% --popup bottom,40% --layout reverse --border top'
> ``` > ```
### Search syntax ### 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 Display modes for these bindings can be separately configured via
`FZF_{CTRL_T,CTRL_R,ALT_C}_OPTS` or globally via `FZF_DEFAULT_OPTS`. `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). More tips can be found on [the wiki page](https://github.com/junegunn/fzf/wiki/Configuring-shell-key-bindings).