Ecosyste.ms: Awesome
An open API service indexing awesome lists of open source software.
https://github.com/brokenricefilms/tmux-fzf-session-switch
Easy way to switch, when you have a ton of sessions.
https://github.com/brokenricefilms/tmux-fzf-session-switch
fzf fzf-scripts tmux tmux-plugins
Last synced: 4 days ago
JSON representation
Easy way to switch, when you have a ton of 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 (almost 3 years ago)
- Default Branch: main
- Last Pushed: 2023-12-28T13:25:42.000Z (6 months ago)
- Last Synced: 2024-06-12T20:52:00.305Z (15 days ago)
- Topics: fzf, fzf-scripts, tmux, tmux-plugins
- Language: Shell
- Homepage: https://ongedit.github.io/
- Size: 525 KB
- Stars: 40
- Watchers: 1
- Forks: 4
- Open Issues: 1
-
Metadata Files:
- Readme: README.md
- License: LICENSE
Lists
- awesome-stars - brokenricefilms/tmux-fzf-session-switch - Easy way to switch, when you have a ton of sessions. (Shell)
- awesome-tmux - tmux-fzf-session-switch
README
# TMUX FZF Session Switch
> I no longer use tmux cuz i'm in windows now and i switch to video editor so i think, I no longer dev new feat **but** you can. Welcome Pull request or be the active maintainer
## QnA
### Can do?
1. Session + window name fuzzy search and switch.
2. Create a new session
### Reason don't 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.
### Reason for using this plugin?
One single shortcut for switching sessions, windows, and creating new sessions. This makes simple flow, "i want to go to ? press shortcut type ? enter done.", "i want to go to ?, press shortcut type ?, Uh! not have that okay press enter to create new session with? name"
### Plan
Blazingly fast Tmux workflow, built muscle memory, better DX.
### Not in plan
Becoming Chad, have super black magic power like [tmux-fzf](https://github.com/sainnhe/tmux-fzf)
### Why I don't create a push request to the main repo?
"Don't confirm `y` to create a new session". This one different flow from the original repo. So that's why I don't push requests into the original repo.
## Getting started
- Video:
- Tutorial: https://youtu.be/WJEphxyKAbw
- Demo v2, session + window search: https://youtu.be/XWdDwQJgUmw
- Install the [tpm](https://github.com/tmux-plugins/tpm) Tmux Plugin Manager.
- Put `set -g @plugin 'thuantanphamfilms/tmux-fzf-session-switch'` into your tmux config
- Use tpm to install this plugin. Default you can press `prefix + I` (`I` is
`shift + i` = I)
- `Prefix + Ctrl + f`: Open up fzf in a new tab. (e.g. prefix = ctrl + b. Hold ctrl -> press a -> press f -> done)
- If you type a name that doesn't exist, you will be prompted to create it.
> If this name conflicts with another session name -> add a double/single quotes `'example'`
## Requirements
- [Tmux >= 3.3a](https://github.com/thuantanphamfilms/tmux-fzf-session-switch/pull/5/files) `pop-up menu`
- [fzf](https://github.com/junegunn/fzf)
## 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
### Use in command line
```bash
function tmuxSessionSwitch() {
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
}
```
> use with `clear` command is the best
```
alias clear='tmux_kill_uname_session ; clear -x'
```
### Easy to press
- In my use case, I don't use this keybinding for switch sessions, I use `hold space + ;` mapping for `hold Ctrl + a + f`
- How can I use `hold space + ;` mapping?
-> I use [input remapper](https://github.com/sezanzeb/input-remapper), also you can see [my dotfiles](https://github.com/thuantanphamfilms/dotfiles)
> config in GUI
```python
space: if_single(key(KEY_SPACE), ,timeout=10000)
space + semicolon: KEY_RIGHTCTRL+a+f
```
![input remapper][img_input_remapper]
[img_input_remapper]: ./img/input_remapper.png