From bf65e8cd12b0477a916ed16fa6d9d3ff9a78c824 Mon Sep 17 00:00:00 2001 From: Junegunn Choi Date: Tue, 31 Mar 2020 22:18:09 +0900 Subject: [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%' --- man/man1/fzf-tmux.1 | 30 ++++++++++++++++++++++-------- 1 file changed, 22 insertions(+), 8 deletions(-) (limited to 'man') 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) -- cgit v1.2.3