diff options
author | Junegunn Choi <junegunn.c@gmail.com> | 2020-03-31 22:18:09 +0900 |
---|---|---|
committer | Junegunn Choi <junegunn.c@gmail.com> | 2020-04-03 13:23:15 +0900 |
commit | bf65e8cd12b0477a916ed16fa6d9d3ff9a78c824 (patch) | |
tree | b2717ffe44d0d548a63359e5d18659bf6bb02a17 /man | |
parent | 0f5c6e8f040833ca632bb5ff345542879769225c (diff) |
[fzf-tmux] Add option to start fzf in tmux popup window
Requires latest tmux built from source (e.g. brew install tmux --HEAD)
Examples:
# 50%/50% width and height on the center of the screen
fzf-tmux -p
# 80%/80%
fzf-tmux -p80%
# 80%/40%
fzf-tmux -p80%,40%
# Separate -w and -h
fzf-tmux -w80% -h40%
# 80%/40% at position (0, 0)
fzf-tmux -w80% -h40% -x0 -y0
You can configure key bindings and fuzzy completion to open in tmux
popup window like so:
FZF_TMUX_OPTS='-p 80%'
Diffstat (limited to 'man')
-rw-r--r-- | man/man1/fzf-tmux.1 | 30 |
1 files changed, 22 insertions, 8 deletions
diff --git a/man/man1/fzf-tmux.1 b/man/man1/fzf-tmux.1 index 1f471342..b559d793 100644 --- a/man/man1/fzf-tmux.1 +++ b/man/man1/fzf-tmux.1 @@ -27,19 +27,33 @@ THE SOFTWARE. fzf-tmux - open fzf in tmux split pane .SH SYNOPSIS -.B fzf-tmux [-u|-d [HEIGHT[%]]] [-l|-r [WIDTH[%]]] [--] [FZF OPTIONS] +.B fzf-tmux [LAYOUT OPTIONS] [--] [FZF OPTIONS] .SH DESCRIPTION -fzf-tmux is a wrapper script for fzf that opens fzf in a tmux split pane. It is -designed to work just like fzf except that it does not take up the whole -screen. You can safely use fzf-tmux instead of fzf in your scripts as the extra -options will be silently ignored if you're not on tmux. +fzf-tmux is a wrapper script for fzf that opens fzf in a tmux split pane or in +a tmux popup window. It is designed to work just like fzf except that it does +not take up the whole screen. You can safely use fzf-tmux instead of fzf in +your scripts as the extra options will be silently ignored if you're not on +tmux. -.SH OPTIONS -.SS Layout +.SH LAYOUT OPTIONS -(default: \fB-d 50%\fR) +(default layout: \fB-d 50%\fR) +.SS Popup window +(requires tmux 3.2 or above) +.TP +.B "-p [WIDTH[%][,HEIGHT[%]]]" +.TP +.B "-w WIDTH[%]" +.TP +.B "-h WIDTH[%]" +.TP +.B "-x COL" +.TP +.B "-y ROW" + +.SS Split pane .TP .B "-u [height[%]]" Split above (up) |