twin/fzf
1
0
Fork 0
mirror of https://github.com/junegunn/fzf.git synced 2025-05-19 12:50:22 -07:00
Code Issues Packages Projects Releases Wiki Activity

Update ADVANCED.md: Use --tmux instead of fzf-tmux

Browse Source
This commit is contained in:
Junegunn Choi 2024-06-03 09:41:40 +09:00
parent c29533994f
commit d453e6d7db
No known key found for this signature in database
GPG Key ID: 254BC280FEF9C627
1 changed files with 38 additions and 40 deletions
Show Stats Download Patch File Download Diff File Expand all files Collapse all files

78
ADVANCED.md
View File

@ -1,18 +1,17 @@
Advanced fzf examples Advanced fzf examples
====================== ======================
* *Last update: 2024/01/20* * *Last update: 2024/06/03*
* *Requires fzf 0.46.0 or above* * *Requires fzf 0.53.0 or later*
--- ---
<!-- vim-markdown-toc GFM --> <!-- vim-markdown-toc GFM -->
* [Introduction](#introduction) * [Introduction](#introduction)
* [Screen Layout](#screen-layout) * [Display modes](#display-modes)
* [`--height`](#--height) * [`--height`](#--height)
* [`fzf-tmux`](#fzf-tmux) * [`--tmux`](#--tmux)
* [Popup window support](#popup-window-support)
* [Dynamic reloading of the list](#dynamic-reloading-of-the-list) * [Dynamic reloading of the list](#dynamic-reloading-of-the-list)
* [Updating the list of processes by pressing CTRL-R](#updating-the-list-of-processes-by-pressing-ctrl-r) * [Updating the list of processes by pressing CTRL-R](#updating-the-list-of-processes-by-pressing-ctrl-r)
* [Toggling between data sources](#toggling-between-data-sources) * [Toggling between data sources](#toggling-between-data-sources)
@ -63,7 +62,7 @@ learn its wide variety of features.
This document will guide you through some examples that will familiarize you This document will guide you through some examples that will familiarize you
with the advanced features of fzf. with the advanced features of fzf.
Screen Layout Display modes
------------- -------------
### `--height` ### `--height`
@ -104,56 +103,55 @@ Define `$FZF_DEFAULT_OPTS` like so:
export FZF_DEFAULT_OPTS="--height=40% --layout=reverse --info=inline --border --margin=1 --padding=1" export FZF_DEFAULT_OPTS="--height=40% --layout=reverse --info=inline --border --margin=1 --padding=1"
``` ```
### `fzf-tmux` ### `--tmux`
Before fzf had `--height` option, we would open fzf in a tmux split pane not (Requires tmux 3.3 or later)
to take up the whole screen. This is done using `fzf-tmux` script.
If you're using tmux, you can open fzf in a tmux popup using `--tmux` option.
```sh ```sh
# Open fzf on a tmux split pane below the current pane. # Open fzf in a tmux popup at the center of the screen with 70% width and height
# Takes the same set of options. fzf --tmux 70%
fzf-tmux --layout=reverse
``` ```
![image](https://user-images.githubusercontent.com/700826/113379973-f1cc6500-93b5-11eb-8860-c9bc4498aadf.png) ![image](https://github.com/junegunn/fzf/assets/700826/9c365405-c700-49b2-8985-60d822ed4cff)
The limitation of `fzf-tmux` is that it only works when you're on tmux unlike `--tmux` option is silently ignored if you're not on tmux. So if you're trying
`--height` option. But the advantage of it is that it's more flexible. to avoid opening fzf in fullscreen, try specifying both `--height` and `--tmux`.
(See `man fzf-tmux` for available options.)
```sh ```sh
# On the right (50%) # --tmux is specified later so it takes precedence over --height when on tmux.
fzf-tmux -r # If you're not on tmux, --tmux is ignored and --height is used instead.
fzf --height 70% --tmux 70%
# On the left (30%)
fzf-tmux -l30%
# Above the cursor
fzf-tmux -u30%
``` ```
![image](https://user-images.githubusercontent.com/700826/113379983-fa24a000-93b5-11eb-93eb-8a3d39b2f163.png) You can also specify the position, width, and height of the popup window in
the following format:
![image](https://user-images.githubusercontent.com/700826/113380001-0577cb80-93b6-11eb-95d0-2ba453866882.png) * `[center|top|bottom|left|right][,SIZE[%]][,SIZE[%]]`
![image](https://user-images.githubusercontent.com/700826/113380040-1d4f4f80-93b6-11eb-9bef-737fb120aafe.png)
#### Popup window support
But here's the really cool part; tmux 3.2 added support for popup windows. So
you can open fzf in a popup window, which is quite useful if you frequently
use split panes.
```sh ```sh
# Open tmux in a tmux popup window (default size: 50% of the screen) # 100% width and 60% height
fzf-tmux -p fzf --tmux 100%,60% --border horizontal
# 80% width, 60% height
fzf-tmux -p 80%,60%
``` ```
![image](https://user-images.githubusercontent.com/700826/113380106-4a9bfd80-93b6-11eb-8cee-aeb1c4ce1a1f.png) ![image](https://github.com/junegunn/fzf/assets/700826/f80d3514-d69f-42f2-a8de-a392a562bfcf)
```sh
# On the right (50% width)
fzf --tmux right
```
![image](https://github.com/junegunn/fzf/assets/700826/4033ade4-7efa-421b-a3fb-a430d197098a)
```sh
# On the left (40% width and 70% height)
fzf --tmux left,40%,70%
```
![image](https://github.com/junegunn/fzf/assets/700826/efe43881-2bf0-49ea-ab2e-1377f778cd52)
> [!TIP]
> You might also want to check out my tmux plugins which support this popup > You might also want to check out my tmux plugins which support this popup
> window layout. > window layout.
> >