https://github.com/viniarck/rofi-tmux

:heavy_check_mark: rft (rofi-tmux). Quickly switches tmux sessions, windows and tmuxinator projects
https://github.com/viniarck/rofi-tmux

i3wm python rofi tmux

Last synced: about 2 months ago
JSON representation

:heavy_check_mark: rft (rofi-tmux). Quickly switches tmux sessions, windows and tmuxinator projects

• Host: GitHub
• URL: https://github.com/viniarck/rofi-tmux
• Owner: viniarck
• License: mit
• Created: 2018-01-24T01:16:47.000Z (over 6 years ago)
• Default Branch: master
• Last Pushed: 2024-05-17T14:31:27.000Z (4 months ago)
• Last Synced: 2024-07-18T07:10:23.451Z (2 months ago)
• Topics: i3wm, python, rofi, tmux
• Language: Python
• Homepage:
• Size: 34.2 KB
• Stars: 25
• Watchers: 3
• Forks: 4
• Open Issues: 0
• Metadata Files:
  • Readme: README.md
  • License: LICENSE

Awesome Lists containing this project

README

        
[![Documentation Status](https://readthedocs.org/projects/rofi-tmux/badge/?version=latest)](http://rofi-tmux.readthedocs.io/en/latest/?badge=latest) [![PyPI](https://img.shields.io/pypi/v/rofi-tmux.svg)](https://pypi.python.org/pypi/rofi-tmux)

## rft (rofi-tmux)

![rft](docs/images/rft.png)

Quickly switches tmux sessions, windows and tmuxinator projects on rofi. Integrates with [i3wm](http://www.i3wm.org) for a smoother switching workflow, if you have multiple workspaces.

### Use Case

I developed rft (rofi-tmux) to optimize my context-switching workflow. As a user who rely completely on tmux for anything shell related, I wanted to have a fuzzy finder switcher, to locate any tmux session or window with seamless integration with i3wm. I guess I've got spoiled by fuzzy finders. Watch the screencast bellow and you'll see what I mean :)

### Features

- Switch or kill any tmux session.

- Switch or kill any tmux window, either globally or within the current session.

- Switch to any tmuxinator project.

- Cache last tmux session and window for fast switching back and forth, decreases the number of keystrokes.

- Integration with i3wm for switching to the right workspace seamlessly.

- Extensible for other window managers.

### Installation

```

pip3 install rofi-tmux --user -U

```

### Screencast

[![rft-demo](https://img.youtube.com/vi/o6tBNFJW28c/0.jpg)](https://www.youtube.com/watch?v=o6tBNFJW28c)

### Usage

Check [ReadTheDocs](http://rofi-tmux.readthedocs.io/) for detailed information, usage and suggested key bindings.

### Contributing

Contributions are more than welcome. Let me know if you want to add other features or integrations, or if you are having trouble to use rft, open an issue. Join the [chat on gitter.im/rofi-tmux/community](https://gitter.im/rofi-tmux/community) if you want to discuss ideas.

### License

MIT