aboutsummaryrefslogtreecommitdiffstats
path: root/src
diff options
context:
space:
mode:
authorEugene Triguba <hello@eugenetriguba.com>2026-11-14 11:08:59 -0800
committerEugene Triguba <hello@eugenetriguba.com>2026-11-14 11:08:59 -0800
commit36f7df56164df73c7af867d8ed478a9b572aee40 (patch)
tree0e46940d56b58e2b473b872a8bc4fac9d69a3d33 /src
parentFix links to docs images in readme and update install instructions (diff)
downloadtmux-toggle-term-36f7df56164df73c7af867d8ed478a9b572aee40.zip
Move source files to src/ directory and add test script to scripts/
Diffstat (limited to 'src')
-rwxr-xr-xsrc/main.sh77
-rwxr-xr-xsrc/tmux.sh19
-rwxr-xr-xsrc/toggle-term.sh98
3 files changed, 194 insertions, 0 deletions
diff --git a/src/main.sh b/src/main.sh
new file mode 100755
index 0000000..4bc01c2
--- /dev/null
+++ b/src/main.sh
@@ -0,0 +1,77 @@
+#!/bin/sh
+set -o errexit
+set -o nounset
+
+CURRENT_DIR="$(dirname "$0")"
+. "$CURRENT_DIR/tmux.sh"
+
+FLOAT_KEYBINDING="C-f"
+FLOAT_KEYBINDING_OPTION="@toggle-term-float-key"
+FLOAT_USE_PREFIX_OPTION="@toggle-term-float-use-prefix"
+FLOAT_ENABLED_OPTION="@toggle-term-float-enabled"
+
+SPLIT_KEYBINDING="C-\;"
+SPLIT_KEYBINDING_OPTION="@toggle-term-split-key"
+SPLIT_USE_PREFIX_OPTION="@toggle-term-split-use-prefix"
+SPLIT_ENABLED_OPTION="@toggle-term-split-enabled"
+
+main() {
+ tmux_cmd="$(get_tmux_cmd)"
+
+ if [ "$(float_enabled)" = "true" ]; then
+ float_key_binding="$(float_key)"
+ if [ "$(use_prefix_for_float)" = "true" ]; then
+ $tmux_cmd bind-key "$float_key_binding" run-shell -b "$CURRENT_DIR/toggle-term.sh float"
+ else
+ $tmux_cmd bind-key -n "$float_key_binding" run-shell -b "$CURRENT_DIR/toggle-term.sh float"
+ fi
+ fi
+
+ if [ "$(split_enabled)" = "true" ]; then
+ split_key_binding="$(split_key)"
+ if [ "$(use_prefix_for_split)" = "true" ]; then
+ $tmux_cmd bind-key "$split_key_binding" run-shell -b "$CURRENT_DIR/toggle-term.sh split"
+ else
+ $tmux_cmd bind-key -n "$split_key_binding" run-shell -b "$CURRENT_DIR/toggle-term.sh split"
+ fi
+ fi
+}
+
+float_key() {
+ get_tmux_option "$FLOAT_KEYBINDING_OPTION" "$FLOAT_KEYBINDING"
+}
+
+use_prefix_for_float() {
+ get_tmux_option "$FLOAT_USE_PREFIX_OPTION" "false"
+}
+
+split_key() {
+ get_tmux_option "$SPLIT_KEYBINDING_OPTION" "$SPLIT_KEYBINDING"
+}
+
+use_prefix_for_split() {
+ get_tmux_option "$SPLIT_USE_PREFIX_OPTION" "false"
+}
+
+float_enabled() {
+ get_tmux_option "$FLOAT_ENABLED_OPTION" "true"
+}
+
+split_enabled() {
+ get_tmux_option "$SPLIT_ENABLED_OPTION" "true"
+}
+
+get_tmux_option() {
+ option="$1"
+ default_value="$2"
+ tmux_cmd=$(get_tmux_cmd)
+
+ option_value=$($tmux_cmd show-option -gqv "$option")
+ if [ -z "$option_value" ]; then
+ echo "$default_value"
+ else
+ echo "$option_value"
+ fi
+}
+
+main
diff --git a/src/tmux.sh b/src/tmux.sh
new file mode 100755
index 0000000..2be86de
--- /dev/null
+++ b/src/tmux.sh
@@ -0,0 +1,19 @@
+#!/bin/sh
+set -o errexit
+set -o nounset
+
+get_tmux_cmd() {
+ TMUX_CMD="tmux"
+ # The script supports targeting a different tmux socket
+ # or configuration file solely for testing purposes. This
+ # allows isolation between the tmux installation on the host
+ # and the tmux session for the test run.
+ if [ -n "${TMUX_SOCKET:-}" ]; then
+ if [ -n "${TMUX_CONFIG_PATH:-}" ]; then
+ TMUX_CMD="tmux -f $TMUX_CONFIG_PATH -L $TMUX_SOCKET"
+ else
+ TMUX_CMD="tmux -L $TMUX_SOCKET"
+ fi
+ fi
+ echo "$TMUX_CMD"
+}
diff --git a/src/toggle-term.sh b/src/toggle-term.sh
new file mode 100755
index 0000000..3554ec0
--- /dev/null
+++ b/src/toggle-term.sh
@@ -0,0 +1,98 @@
+#!/bin/sh
+set -o errexit
+set -o nounset
+
+CURRENT_DIR="$(dirname "$0")"
+. "$CURRENT_DIR/tmux.sh"
+
+POPUP_SESSION_NAME="popup"
+
+main() {
+ TMUX_CMD=$(get_tmux_cmd)
+ # Modes:
+ # float → global floating window
+ # split → per-window split pane
+ mode="$1"
+ case "${mode}" in
+ float)
+ toggle_popup
+ ;;
+ split)
+ toggle_split
+ ;;
+ *)
+ echo "Usage: $0 [split|float]" >&2
+ exit 1
+ ;;
+ esac
+}
+
+toggle_popup() {
+ if $TMUX_CMD has-session -t "$POPUP_SESSION_NAME" 2>/dev/null; then
+ current_session="$($TMUX_CMD display-message -p '#{session_name}')"
+ if [ "$current_session" = "$POPUP_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 $POPUP_SESSION_NAME"
+ fi
+ else
+ $TMUX_CMD display-popup -d '#{pane_current_path}' -xC -yC -w90% -h80% \
+ -E "$TMUX_CMD new -s $POPUP_SESSION_NAME"
+ fi
+}
+
+toggle_split() {
+ # When we list the tmux panes out with the window flags,
+ # when there are no special flags for the panes, the output
+ # looks like the following for 3 panes:
+ # *
+ # *
+ # *
+ panes_list="$($TMUX_CMD list-panes -F '#{window_flags}')"
+ pane_count="$(echo "${panes_list}" | wc -l | sed 's/^[[:space:]]*//g')"
+ if [ "${pane_count}" = 1 ]; then
+ # And when we only have 1 pane, we want to split it into two
+ # and open a new one at the current path of the first pane.
+ # This is what initially creates the 'split'.
+ $TMUX_CMD split-window -c "#{pane_current_path}"
+ return
+ fi
+
+ # However, if we've zoomed in a pane, all the panes will have
+ # a 'Z' to indicate the window is zoomed in:
+ # *Z
+ # *Z
+ #
+ # Note that we're printing the 'window_flags' per pane. There
+ # is no concept of 'pane flags', so every pane here has a Z to
+ # indicate the window is zoomed, but this output doesn't indicate
+ # which pane is the one zoomed in.
+ #
+ # If we have a zoomed in pane, that means we opened our split pane
+ # and toggled it, so it is closed, and now we want to open it again.
+ # In this case, our single main zoomed in window would be what is on
+ # the screen and we want to open back up our split pane.
+ if echo "${panes_list}" | grep -q Z; then
+ # To open back up our split pane, we can switch focus to the previously
+ # active pane in the current window of the current session.
+ #
+ # : = current session
+ # . = current window
+ # - = previously active pane
+ $TMUX_CMD select-pane -t:.-
+ return
+ fi
+
+ # If we have more than 1 pane and none are zoomed in, we can assume the
+ # screen has the split pane open.
+ #
+ # So, to simulate 'toggling' between the main (first) pane and the split
+ # pane, we 'zoom' the main pane so it takes up the full screen. Because
+ # the initial pane index is configurable in tmux, we grab the first pane
+ # index dynamically.
+ first_pane_index="$($TMUX_CMD list-panes -F '#{pane_index}' | head -n1)"
+ $TMUX_CMD resize-pane -Z -t"$first_pane_index"
+}
+
+main "$@"