fzf-tmux(1)

🌸 NAME 🌸

okay so bestie, this is fzf-tmux(1) — the manual for fzf-tmux, aka open fzf in tmux split pane. lowkey iconic, highkey useful. it's giving fzf but make it live in a tmux pane. 💅

🦋 SYNOPSIS 🦋

fzf-tmux [LAYOUT OPTIONS] [--] [FZF OPTIONS]

💖 DESCRIPTION 💖

fzf-tmux is a wrapper script for fzf that opens fzf in a tmux split pane or in a tmux popup window. no cap, it slays. ✨

it is designed to work just like fzf except that it does not take up the whole screen. main character energy, but polite about your screen real estate 🫶.

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. fr fr, it just vibes either way 💜.

🌈 LAYOUT OPTIONS 🌈

default layout: -d 50% — that's the one you get if you don't choose anything else, bestie 💅.

🎀 Popup window 🎀

(requires tmux 3.2 or above) — periodt, no cap.

• -p [WIDTH[%][,HEIGHT[%]]] — popup window layout option, exactly this shape: [WIDTH[%][,HEIGHT[%]]].
• -w WIDTH[%] — popup window layout option, exactly this shape: WIDTH[%].
• -h WIDTH[%] — popup window layout option, exactly this shape: WIDTH[%] (yes bestie, -h but the manual says WIDTH[%] — leaving it untouched 💀).
• -x COL — popup window layout option, exactly this shape: COL.
• -y ROW — popup window layout option, exactly this shape: ROW.

🦋 Split pane 🦋

• -u [height[%]] — Split above (up).
• -d [height[%]] — Split below (down).
• -l [width[%]] — Split left.
• -r [width[%]] — Split right.

---

mwah! that's the whole page, iykyk 💅. this manual page is from fzf 0.74.5, dated Oct 2026 💖✨