Ecosyste.ms: Awesome
An open API service indexing awesome lists of open source software.
https://github.com/erikjuhani/tm
Tmux session manager with fzf and zoxide
https://github.com/erikjuhani/tm
fzf manager posix shell-script shm tmux zoxide
Last synced: about 1 month ago
JSON representation
Tmux session manager with fzf and zoxide
- Host: GitHub
- URL: https://github.com/erikjuhani/tm
- Owner: erikjuhani
- License: mit
- Created: 2023-10-27T21:02:09.000Z (about 1 year ago)
- Default Branch: main
- Last Pushed: 2024-03-04T20:30:58.000Z (10 months ago)
- Last Synced: 2024-04-22T15:25:08.483Z (9 months ago)
- Topics: fzf, manager, posix, shell-script, shm, tmux, zoxide
- Language: Shell
- Homepage:
- Size: 581 KB
- Stars: 0
- Watchers: 1
- Forks: 0
- Open Issues: 0
-
Metadata Files:
- Readme: README.md
- License: LICENSE
Awesome Lists containing this project
README
# tm
tmux session manager using `fzf` and `zoxide`. Requires
[tmux](https://github.com/tmux/tmux/wiki/Installing),
[zoxide](https://github.com/ajeetdsouza/zoxide#installation) and
[fzf](https://github.com/junegunn/fzf#installation) to be available in the
system path.
The name abbreviation is from words *t*mux *m*anager.
## Screenshot
## Installation
Easiest way to install `tm` is with [shm](https://github.com/erikjuhani/shm).
To install `shm` run either one of these oneliners:
curl:
```sh
curl -sSL https://raw.githubusercontent.com/erikjuhani/shm/main/shm.sh | sh
```
wget:
```sh
wget -qO- https://raw.githubusercontent.com/erikjuhani/shm/main/shm.sh | sh
```
then run:
```sh
shm get erikjuhani/tm
```
to get the latest version of `tm`.
## Usage
`tm` is best used as a popup for tmux. To use the `tm` opener with tmux, add
the following line to your `.tmux.conf` file (usually located in `~/.tmux.conf`):
```
bind-key -n C-f run-shell "tmux popup -E 'tm open || exit 0'"
```
In the above snippet, we bind the key Control+f to run a popup with the `tm open` command.
The `exit 0` code is used to prevent displaying errors if the exit code is
anything other than zero.
After saving the configuration file, you should source the configuration using
the tmux Command Key and run `:source ~/.tmux.conf`.
Now you should be ready to use `tm` with a tmux popup.
```sh
tm [] [] [-h | --help]
```
### Open
Open a fuzzy finder with all the existing sessions, including directories
recorded by zoxide. The session path consists of a list of directories returned
by `zoxide query -l` and any existing tmux sessions, which are represented as
`session://`.
```
tm open
```
### Close
Close the current session, or, if given a session name, close that session
instead.
```
tm close []
```
### Rename
Rename the current tmux session with the provided new name, or alternatively,
use the basename of the current working directory.
```
tm rename []
```