From 1b0d448c6e1eb2df1a3d364fcb8a71e30a9f53cf Mon Sep 17 00:00:00 2001 From: Junegunn Choi Date: Sun, 12 Apr 2026 09:57:26 +0900 Subject: [PATCH] Update README: --tmux -> --popup --- README.md | 31 ++++++++++++++++--------------- 1 file changed, 16 insertions(+), 15 deletions(-) diff --git a/README.md b/README.md index f0f7f63d..fdd6c5ef 100644 --- a/README.md +++ b/README.md @@ -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).