diff options
| author | Eugene Triguba <hello@eugenetriguba.com> | 2025-08-16 08:26:57 -0400 |
|---|---|---|
| committer | Eugene Triguba <hello@eugenetriguba.com> | 2025-08-16 08:26:57 -0400 |
| commit | f91a7f6cf37202841224724614d5051378ea57be (patch) | |
| tree | 9cba206169e9bffa1b0e9f4883bc6b65cdc86b20 | |
| download | tmux-toggle-term-f91a7f6cf37202841224724614d5051378ea57be.zip | |
Initial Commit
| -rw-r--r-- | README.md | 25 | ||||
| -rw-r--r-- | plugin.tmux | 7 | ||||
| -rwxr-xr-x | toggle-term.sh | 57 |
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 "$@" |