stumpwm.stumpwm-contrib

mirror of https://github.com/stumpwm/stumpwm-contrib.git synced 2026-09-10 07:26:25 -04:00

History

Kirill A. Korinsky 5df5bcfd93 Tmux session manager for StumpWM This is a small module which allows to connect existed tmux session, or start a new one		2026-01-07 21:32:32 +01:00
..
package.lisp	Tmux session manager for StumpWM	2026-01-07 21:32:32 +01:00
README.org	Tmux session manager for StumpWM	2026-01-07 21:32:32 +01:00
swm-tmux.asd	Tmux session manager for StumpWM	2026-01-07 21:32:32 +01:00
swm-tmux.lisp	Tmux session manager for StumpWM	2026-01-07 21:32:32 +01:00

README.org

Requirements
Usage
Commands
- swm-tmux-session
- swm-tmux-new-session
Variables

Requirements

cl-ppcre

Install cl-ppcre from the REPL:
```
(ql:quickload :cl-ppcre)
```

Usage

This module provides a menu interface for managing tmux sessions. You can attach to existing sessions or create new ones. Session names default to the current StumpWM group name.

Put the following in your ~/.stumpwmrc

(load-module "swm-tmux")

And define a keybind in your ~/.stumpwmrc

(define-key *root-map* (kbd "t") "swm-tmux-session")

Commands

swm-tmux-session

Opens a menu to select an existing tmux session or create a new one. The session name defaults to the current group name.

swm-tmux-new-session

Quickly creates a new tmux session with an auto-generated name based on the current group.

Variables

swm-tmux-default-term

Terminal emulator to use. Default is xterm.

(setf swm-tmux:*swm-tmux-default-term* "urxvtc")

swm-tmux-default-term-title-opt

Command line option for setting the terminal title. Default is -T. Set to NIL if your terminal does not support a title option.

(setf swm-tmux:*swm-tmux-default-term-title-opt* "-title")

swm-tmux-default-term-exec-opt

Command line option for executing a command in the terminal. Default is -e.

(setf swm-tmux:*swm-tmux-default-term-exec-opt* "-e")