Ecosyste.ms: Awesome
An open API service indexing awesome lists of open source software.
https://github.com/brokenricefilms/tmux-fzf-session-switch
Easy ways to switch between tons of tmux sessions
https://github.com/brokenricefilms/tmux-fzf-session-switch
cli cli-app command-line command-line-tool fzf fzf-command fzf-plugin fzf-scripts productivity terminal terminal-based tmux tmux-conf tmux-configs tmux-configuration tmux-plugin tmux-plugins
Last synced: 3 months ago
JSON representation
Easy ways to switch between tons of tmux sessions
- Host: GitHub
- URL: https://github.com/brokenricefilms/tmux-fzf-session-switch
- Owner: brokenricefilms
- License: gpl-3.0
- Fork: true (rcribbs/tmux-fzf-session-switch)
- Created: 2021-09-14T04:23:34.000Z (about 3 years ago)
- Default Branch: main
- Last Pushed: 2024-07-31T17:13:16.000Z (3 months ago)
- Last Synced: 2024-07-31T21:13:42.219Z (3 months ago)
- Topics: cli, cli-app, command-line, command-line-tool, fzf, fzf-command, fzf-plugin, fzf-scripts, productivity, terminal, terminal-based, tmux, tmux-conf, tmux-configs, tmux-configuration, tmux-plugin, tmux-plugins
- Language: Shell
- Homepage: https://brokenricefilms.pages.dev
- Size: 775 KB
- Stars: 43
- Watchers: 1
- Forks: 6
- Open Issues: 1
-
Metadata Files:
- Readme: README.md
- License: LICENSE
Awesome Lists containing this project
- awesome-tmux - tmux-fzf-session-switch
README
# TMUX FZF Session Switch
## Video demo
[](https://www.youtube.com/watch?v=70jzB1SU5as)
## QnA
### Features:
1. Fuzzy search and switch sessions and windows.
2. Create new sessions.
### What are the reasons not to use this plugin?
1. [tmux-fzf](https://github.com/sainnhe/tmux-fzf) have more black magic.
2. [tmux-fzf](https://github.com/sainnhe/tmux-fzf) have single shortcut for [switch session](https://github.com/sainnhe/tmux-fzf/issues/6) and many function [tmux-fzf](https://github.com/sainnhe/tmux-fzf) had.
### What are the reasons for using this plugin?
This plugin offers a single shortcut for switching between sessions, windows, and creating new sessions.
This creates a simple workflow: "I want to go to [session/window name], press the shortcut, type the name, and press enter. Done!"
Or:
"I want to go to [session/window name], press the shortcut, type the name. Uh oh, it doesn't exist. Okay, press `enter` to create a new session with that name."
### Plan
Blazingly fast Tmux workflow, built muscle memory, better developer experience.
### Not in plan
Having multiple features like [tmux-fzf](https://github.com/sainnhe/tmux-fzf)
## Requirements
- [Tmux >= 3.3a](https://github.com/brokenricefilms/tmux-fzf-session-switch/pull/5/files) (for the `pop-up menu` feature)
- [fzf](https://github.com/junegunn/fzf)
## Getting Started
1. **Install the Tmux Plugin Manager (TPM):**
Follow the instructions at [https://github.com/tmux-plugins/tpm](https://github.com/tmux-plugins/tpm) to install TPM.
2. **Add the Plugin to Your Tmux Config:**
Add the following line to your `~/.tmux.conf` file:
```
set -g @plugin 'brokenricefilms/tmux-fzf-session-switch'
```
3. **Install the Plugin:**
Use TPM to install the plugin. By default, you can press `prefix + I` (where `prefix` is your tmux prefix key, usually `Ctrl + b`, and `I` is `Shift + i`).
4. **Open FZF for Session Switching:**
Press `prefix + Ctrl + f` to open FZF in a new tab. (For example, if your prefix is `Ctrl + b`, hold `Ctrl`, press `b`, then press `f`).
5. **Creating New Sessions:**
If you type a session name that doesn't exist, you will be prompted to create it.
* **Handling Name Conflicts:** If the name conflicts with an existing session, enclose it in double or single quotes (e.g., `'example'`).
## Customize
> 🫰Thanks to [@erikw](https://github.com/erikw)
### Search session only
```bash
set-option -g @fzf-goto-session-only 'true'
```
### Key binding
```bash
set -g @fzf-goto-session 'key binding'
```
> Eg. to override the default session switcher in tmux available at `prefix + s`:
```bash
set -g @fzf-goto-session 's'
```
#### Without prefix
```bash
set -g @fzf-goto-session-without-prefix 'true'
```
### Window dimensions
```bash
set -g @fzf-goto-win-width WIDTH
set -g @fzf-goto-win-height HEIGHT
```
> Eg.
```bash
set -g @fzf-goto-win-width 70
set -g @fzf-goto-win-height 20
```
## Tips
**Using in the Command Line**
```bash
function tmux_session_switch() {
session=$(tmux list-windows -a | fzf | sed 's/: .*//g')
tmux switch-client -t "$session"
}
```
```bash
function tmux_kill_uname_session() {
echo "kill all unname tmux session"
cd /tmp/
tmux ls | awk '{print $1}' | grep -o '[0-9]\+' >/tmp/killAllUnnameTmuxSessionOutput.sh
sed -i 's/^/tmux kill-session -t /' killAllUnnameTmuxSessionOutput.sh
chmod +x killAllUnnameTmuxSessionOutput.sh
./killAllUnnameTmuxSessionOutput.sh
cd -
tmux ls
}
```
Using this with the `clear` command is effective:
```
alias clear='tmux_kill_uname_session ; clear -x'
```