aboutsummaryrefslogtreecommitdiffstats
diff options
context:
space:
mode:
authorEugene Triguba <hello@eugenetriguba.com>2025-08-16 08:26:57 -0400
committerEugene Triguba <hello@eugenetriguba.com>2025-08-16 08:26:57 -0400
commitf91a7f6cf37202841224724614d5051378ea57be (patch)
tree9cba206169e9bffa1b0e9f4883bc6b65cdc86b20
downloadtmux-toggle-term-f91a7f6cf37202841224724614d5051378ea57be.zip
Initial Commit
-rw-r--r--README.md25
-rw-r--r--plugin.tmux7
-rwxr-xr-xtoggle-term.sh57
3 files changed, 89 insertions, 0 deletions
diff --git a/README.md b/README.md
new file mode 100644
index 0000000..d38da9f
--- /dev/null
+++ b/README.md
@@ -0,0 +1,25 @@
+# tmux-toggle-term
+
+A terminal toggle for tmux that supports a per-window split pane and global floating popups.
+
+## Installation
+
+Using [TPM](https://github.com/tmux-plugins/tpm):
+
+```tmux
+set -g @plugin 'git.sr.ht/~eugenetriguba/tmux-toggle-term'
+```
+
+Reload tmux and press prefix + I to install.
+
+## Usage
+
+- `C-;` → Toggle a split terminal for the current tmux window
+- `C-f` → Toggle a global floating popup terminal
+
+You can override the default hotkeys if desired:
+```tmux
+set -g @toggle_term_key 'M-t'
+set -g @toggle_term_float_key 'M-f'
+```
+
diff --git a/plugin.tmux b/plugin.tmux
new file mode 100644
index 0000000..46432ff
--- /dev/null
+++ b/plugin.tmux
@@ -0,0 +1,7 @@
+if -n "#{==:#{@toggle_term_key},}" \
+ set -g @toggle_term_key 'C-;'
+if -n "#{==:#{@toggle_term_float_key},}" \
+ set -g @toggle_term_float_key 'C-f'
+
+bind-key -n "#{@toggle_term_key}" run-shell -b "#{sourcedir}/toggle-term.sh"
+bind-key -n "#{@toggle_term_float_key}" run-shell -b "#{sourcedir}/toggle-term.sh float"
diff --git a/toggle-term.sh b/toggle-term.sh
new file mode 100755
index 0000000..b80ef97
--- /dev/null
+++ b/toggle-term.sh
@@ -0,0 +1,57 @@
+#!/bin/sh
+# Modes:
+# split → per-window split pane
+# float → global floating window
+
+TMUX_CMD="tmux"
+
+main() {
+ if [ -n "${TMUX_SOCKET:-}" ]; then
+ TMUX_CMD="tmux -L $TMUX_SOCKET"
+ fi
+
+ mode="$1"
+ case "${mode}" in
+ float)
+ toggle_popup "popup"
+ ;;
+ split)
+ toggle_split
+ ;;
+ *)
+ echo "Usage: $0 [split|float]" >&2
+ exit 1
+ ;;
+ esac
+}
+
+toggle_popup() {
+ term_session_name="$1"
+ if $TMUX_CMD has-session -t "$term_session_name" 2>/dev/null; then
+ current_session="$($TMUX_CMD display-message -p '#{session_name}')"
+ if [ "$current_session" = "$term_session_name" ]; then
+ $TMUX_CMD detach-client
+ else
+ $TMUX_CMD display-popup -d '#{pane_current_path}' -xC -yC -w90% -h80% \
+ -E "$TMUX_CMD attach -t $term_session_name"
+ fi
+ else
+ $TMUX_CMD display-popup -d '#{pane_current_path}' -xC -yC -w90% -h80% \
+ -E "$TMUX_CMD new -s $term_session_name"
+ fi
+}
+
+toggle_split() {
+ panes_list="$($TMUX_CMD list-panes -F '#F')"
+ zoomed_panes="$(echo "${panes_list}" | grep Z)"
+ pane_count="$(echo "${panes_list}" | wc -l | bc)"
+ if [ "${pane_count}" = 1 ]; then
+ $TMUX_CMD split-window -c "#{pane_current_path}"
+ elif [ -n "${zoomed_panes}" ]; then
+ $TMUX_CMD select-pane -t:.-
+ else
+ $TMUX_CMD resize-pane -Z -t1
+ fi
+}
+
+main "$@"