https://github.com/rarhoade/tmux-fzf-window
A tmux package to switch windows via fzf
https://github.com/rarhoade/tmux-fzf-window
bash fzf tmux tmux-plugin
Last synced: about 2 months ago
JSON representation
A tmux package to switch windows via fzf
- Host: GitHub
- URL: https://github.com/rarhoade/tmux-fzf-window
- Owner: rarhoade
- License: mit
- Created: 2025-06-25T23:07:52.000Z (11 months ago)
- Default Branch: main
- Last Pushed: 2025-06-26T00:08:08.000Z (11 months ago)
- Last Synced: 2025-07-03T04:50:07.323Z (11 months ago)
- Topics: bash, fzf, tmux, tmux-plugin
- Language: Shell
- Homepage:
- Size: 4.88 KB
- Stars: 0
- Watchers: 0
- Forks: 0
- Open Issues: 0
-
Metadata Files:
- Readme: README.md
- License: LICENSE
Awesome Lists containing this project
README
## Features
* Switches Tmux windows in a session using fzf via popup
## Requirements
* [fzf](https://github.com/junegunn/fzf/)
* [tmux](https://github.com/tmux/tmux/wiki)
## Installation via [TPM](https://github.com/tmux-plugins/tpm)
Add this line to your tmux conf file (either `~/.tmux.conf` or `~/.config/tmux/tmux.conf`)
```tmux
set -g @plugin 'rarhoade/tmux-fzf-window'
```
**Note**: Please use this command to check whether tmux is able to find fzf:
``` bash
tmux run-shell -b 'command -v fzf'
```
## Usage
By default this will run from using `prefix + f`, and load a window showing the options.
From there you can search windows in your tmux session and hit `Enter` to go to the window you'd like
## Rationale
This is meant to be very lightweight and not have all the functionality of [tmux-fzf](https://github.com/sainnhe/tmux-fzf?tab=readme-ov-file)
as I only really use one tmux session at a time and it sounded like a fun project to do.
## Configuration
```conf
# set window width
set -g @fzf-window-option-width 70
# set window height
set -g @fzf-window-option-height 25
# set execution key
set -g @fzf-window-option-key e
```