tmux-tpad

A simple floating window manager for Tmux.

Installation

Make sure you have TPM installed, and add the following line to your tmux.conf configuration file:

set -g @plugin 'Subbeh/tmux-tpad'

Press prefix + I (capital i, as in Install) to fetch the plugin.

Configuration

TPad sessions are defined wtih @tpad-<session_name>-<option> options. The only required option is bind, the rest is optional.

Options

See tmux manual for more information.

Option	Default	Explanation
bind		Keybinding to open session
prefix		Tmux prefix key assigned to session
title	#[fg=magenta,bold] 󱂬 TPad: @instance@	Popup title
dir	$HOME	Startup directory
width	60%	Popup width
height	60%	Popup height
style	fg=blue	Popup formatting style
border_style		Popup border formatting style
border_lines	rounded	Popup border line formatting
pos_x		X position of popup
pos_y		Y position of popup
env		Environement variable for session
cmd		Command to execute in session

Example:

set -g @tpad-scratchpad-bind    "C-p"

set -g @tpad-git-bind           "C-g"
set -g @tpad-git-dir            "#{pane_current_path}"
set -g @tpad-git-cmd            "lazygit"

set -g @tpad-notes-bind         "C-n"
set -g @tpad-notes-style        "fg=yellow"
set -g @tpad-notes-dir          "${NOTES_DIR}"
set -g @tpad-notes-cmd          "nvim -c NvimTreeOpen"
set -g @tpad-notes-prefix       "None"

set -g @tpad-tasks-bind         "C-t"
set -g @tpad-tasks-style        "fg=green"
set -g @tpad-tasks-height       "40%"
set -g @tpad-tasks-width        "40%"
set -g @tpad-tasks-cmd          "taskwarrior-tui"

This will create 3 separate sessions -- scratchpad, git, notes, and tasks.

Usage

Press the prefix key, followed by the key binding defined with the @tpad-<session>-bind option to toggle the popup.

Todo

• Window controls (resize, maximize, etc.)
• Image support (kitty terminal feature)

Acknowledgments

Dismissable Popup Shell in tmux

omerxx/tmux-floax