https://github.com/alihammad-gist/rofintmux

Yet another tmux session manager
https://github.com/alihammad-gist/rofintmux

perl rofi session-management tmux

Last synced: 5 days ago
JSON representation

Yet another tmux session manager

• Host: GitHub
• URL: https://github.com/alihammad-gist/rofintmux
• Owner: alihammad-gist
• Created: 2024-02-12T03:25:25.000Z (12 months ago)
• Default Branch: main
• Last Pushed: 2024-09-22T19:19:24.000Z (4 months ago)
• Last Synced: 2024-11-18T18:02:21.344Z (2 months ago)
• Topics: perl, rofi, session-management, tmux
• Language: Perl
• Homepage:
• Size: 711 KB
• Stars: 0
• Watchers: 1
• Forks: 0
• Open Issues: 1
• Metadata Files:
  • Readme: README.md

Awesome Lists containing this project

README

        
# RofinTmux

![Screenshot of rofintmux](screenshot.png "RofinTmux")

A rofi launcher to create new and navigate active tmux sessions. It

switches the most recently active tmux client to the chosen

session. You'll be asked to choose from a list of available

terminals, if no client is attached to a tmux session.

## Requirements

- [Perl](https://wiki.archlinux.org/title/Perl) 5.20 or newer (most

  linux distros have perl per-installed)

- [Rofi](https://github.com/davatorium/rofi)

- [Zoxide](https://github.com/ajeetdsouza/zoxide)

- [Tmux](https://github.com/tmux/tmux)

- [Nerd Font](https://www.nerdfonts.com/)

## Installation

Download `rofintmux` script from the **Assets** section of the

[release page](https://github.com/alihammad-gist/rofintmux/releases)

. Make sure to download it in a directory contained within your

system's `PATH`. Afterwards run `chmod u+x ~/.local/bin/rofintmux`

to make the script executable, for example if you have saved

`rofintmux` script in `~/.local/bin`.

## Zoxide

The launcher list all visited directories using zoxide. And if any

chosen directory contains `.init_tmux` session initializing

(executable) script, you will be prompted to either run it or

ignore it. Init script will be run with the following CLI

arguments.

1. Session's name

2. Session's current working directory

## Global Initializer scripts

Global initializers can be saved in `~/.tmux/init_tmux` directory.

The following is an example of initializer script

`~/.tmux/init_tmux/notes`. Any scripting or programming language

can be used. As long as the file is executable it will show up in

the launcher.

```perl

#!/usr/bin/perl

use 5.38.0;

my $session = shift @ARGV;

my $cwd     = shift @ARGV;

`tmux send-keys -t $session:0 "zk edit -i" Enter`;

```

This session manager is inspired by

[sesh](https://github.com/joshmedeski/sesh) by John Medeski.