TmuxTerminalManager 1.3

A local web UI for starting, stopping, monitoring, and arranging tmux-managed command cards.

Tmux Manager v1.3

Tmux Manager is a configurable local web UI for starting, stopping, monitoring, and arranging tmux-managed command cards.

Features

• Four card slots per row on wide screens
• Edit Mode for layout changes
• Drag cards into empty slots
• Drop a card onto another card; the card that was there moves to the next available slot
• Card positions are saved in commands.json using a slot field
• Add/edit/delete cards from the UI
• Import/export card layouts as .tmux files
• Each card runs in its own tmux window
• Logs are cached under logs/

Install

sudo apt update
sudo apt install -y tmux python3

Install from PyPI:

python3 -m pip install TmuxTerminalManager

For local development from a clone:

python3 -m pip install -e .

Start

TmuxManager

Open:

http://127.0.0.1:8765

Edit Mode layout

1. Click Edit Mode: Off to turn it on.
2. Empty slots will appear.
3. Click and drag a card.
4. Drop it into an empty slot, or drop it onto another card.
5. Layout saves automatically to ~/.tmux_manager/commands.json.

Runtime files are stored under ~/.tmux_manager by default:

• commands.json for saved cards
• logs/ for cached output
• state/ for tmux-managed process state

Set TMUX_MANAGER_HOME=/path/to/folder before launch to use a different data directory.

Layout files

After setting up cards in the UI, click Export Layout to save the current card layout as a .tmux file.

Click Import Layout to load a saved .tmux file and replace the current cards.

You can also use layout files from the CLI:

TmuxManager my-layout.tmux

Import a layout without starting the UI:

TmuxManager --import-layout my-layout.tmux --no-server

Export the current layout:

TmuxManager --export-layout my-layout.tmux

Example command entries

Isaac Sim alias/function

bash -ic 'isaacsim_ros'

ROS 2 launch

source /opt/ros/humble/setup.bash && source ~/your_ws/install/setup.bash && exec ros2 launch my_pkg my_launch.launch.py

Shell script

bash ./ffmpeg.sh

Docker foreground

docker run --rm -it --name mediamtx your_image

Stop behavior

The UI's Ctrl+C Stop button sends the same thing as pressing Ctrl+C inside the tmux window:

tmux send-keys -t tmux_manager:<card_id> C-c

Foreground commands should stop cleanly.

Background commands using &, nohup, or docker run -d may continue after the shell exits.