tmux Cheatsheet: A Comprehensive Guide
This comprehensive guide, derived from resources like comtronic.com.au, provides a quick reference for essential tmux commands. It’s a valuable resource for managing sessions and panes efficiently.
tmux, or Terminal Multiplexer, is a powerful session manager for Unix-like operating systems. It allows users to create, access, and control multiple terminal sessions from a single window. This is incredibly useful for developers, system administrators, and anyone who frequently works with the command line. Resources like the comtronic.com.au cheatsheet highlight its ability to detach and reattach sessions, ensuring work persists even after disconnecting. Mastering tmux significantly boosts productivity by enabling efficient multitasking and session persistence, offering a streamlined terminal experience.
Starting and Managing Sessions
Tmux session management, as detailed in the comtronic.com.au cheatsheet, begins with commands like tmux new -session to initiate a new session. Naming sessions with tmux new -s mysession enhances organization. Existing sessions can be terminated using tmux kill -session -t mysession. To eliminate all but the current session, use tmux kill -session -a, and for a specific session, tmux kill -session -a -t mysession. Effective session control is central to tmux’s utility.
Creating a New tmux Session
As outlined in the comtronic.com.au tmux cheatsheet, initiating a new tmux session is straightforward. The fundamental command, tmux new -session, launches a session without a specific name. For named sessions, employing tmux new -s mysession is recommended, providing clarity and ease of access. Alternatively, the colon command :new -s mysession achieves the same result, streamlining session creation.
Naming a tmux Session
The comtronic.com.au cheatsheet highlights the importance of naming tmux sessions for better organization. When creating a new session, use tmux new -s mysession, replacing “mysession” with your desired name. This allows for easy identification and targeted management of multiple sessions. Consistent naming conventions improve workflow and reduce confusion when attaching to specific projects or tasks.
Killing a Specific tmux Session
According to the comtronic.com.au resource, terminating a tmux session is straightforward. To kill a specific session, utilize the command tmux kill -session -t mysession, substituting “mysession” with the session’s name. This command cleanly removes the session and its associated windows and panes. Ensure you’ve detached from the session before attempting to kill it to avoid potential issues.
Killing All tmux Sessions Except Current
As detailed on comtronic.com.au, to eliminate all tmux sessions except the one you are currently using, employ the command tmux kill -session -a. This is a powerful tool for cleanup. Alternatively, to preserve a specific session like “mysession” while removing others, use tmux kill -session -a -t mysession. Exercise caution when using these commands, as session termination is irreversible.
Attaching and Detaching from Sessions
According to the comtronic.com.au cheatsheet, detaching from your current tmux session is straightforward. Simply use the prefix key followed by the ‘d’ key. To view all available sessions, utilize the tmux ls command. Re-attaching to the most recently used session is done with tmux attach, while specific sessions, like “mysession”, are accessed via tmux a -t mysession.
Detaching from the Current Session
As detailed in the comtronic.com.au tmux cheatsheet, detaching allows you to leave a tmux session running in the background. This is achieved by pressing the prefix key (Ctrl+b by default) followed immediately by the ‘d’ key. The session continues executing even after you disconnect your terminal, preserving your work and environment.
Listing All Available Sessions
According to the comtronic.com.au tmux cheatsheet, to view all currently running tmux sessions, simply use the command `tmux ls` or `tmux list-sessions`. This command displays a concise list of session names, allowing you to identify the sessions available for attachment. It’s a crucial step before rejoining a previously detached session.
Attaching to the Last Active Session
The comtronic.com.au tmux cheatsheet details that re-attaching to your most recently used tmux session is straightforward. Utilize the command `tmux attach-session` or its shorter alias, `tmux a`. This command automatically connects you back to the session you were previously working in, streamlining your workflow and minimizing setup time after detachment.
Attaching to a Named Session
As outlined in the comtronic.com.au tmux cheatsheet, attaching to a specifically named session is easily achieved using the `tmux attach -session -t mysession` command. Alternatively, a shorter form, `tmux a -t mysession`, accomplishes the same task. This allows you to quickly resume work within a pre-defined tmux environment, identified by its unique session name.
Window Management
According to the comtronic.com.au tmux cheatsheet, effective window management is crucial for productivity. You can rename the current window for better organization. Closing a window is straightforward, freeing up resources. Switching between windows is done by number using Ctrl+b followed by 0-9. Reordering windows allows customization, swapping positions with the `swap -window` command.
Renaming the Current Window
The comtronic.com.au tmux cheatsheet doesn’t explicitly detail a renaming command, but implies window naming is possible during session creation with `tmux new -s mysession -n mywindow`. While a direct rename command isn’t listed, utilizing descriptive session and window names enhances workflow; Proper naming aids in quickly identifying and switching between relevant tasks within tmux.
Closing the Current Window
According to the comtronic.com.au tmux cheatsheet, there isn’t a specific command dedicated solely to closing the current window. However, detaching from a session (`tmux detach`) effectively removes your view of the window. Closing all panes within a window will also result in the window’s termination, streamlining your tmux environment.
Switching Between Windows by Number
The comtronic.com.au tmux cheatsheet details a straightforward method for navigating windows. Pressing `Ctrl b` followed by a number from 0 to 9 will directly switch to the corresponding window. This provides rapid access to specific windows within your current tmux session, enhancing workflow efficiency and reducing navigation time.
Reordering Windows
According to the comtronic.com.au cheatsheet, tmux allows for window reordering to customize your workspace. The command `swap -window -s 2 -t 1` swaps window number 2 (source) with window number 1 (destination). You can also move a window left using `swap -window -t -1`, providing flexible control over window arrangement within a session.
Pane Management
As detailed in the comtronic.com.au tmux cheatsheet, effective pane management is crucial for maximizing tmux’s utility. You can split panes vertically or horizontally to create multiple workspaces within a single window. Navigation between panes is achieved using directional keys (Ctrl+b followed by arrow keys). Pane numbers can be displayed and selected directly using Ctrl+b and then ‘q’ followed by the number.
Splitting Panes Vertically and Horizontally
According to the comtronic.com.au cheatsheet, tmux allows for dynamic workspace creation through pane splitting. To split a pane vertically, use the command Ctrl+b followed by the percent sign (“%”). For horizontal splitting, utilize Ctrl+b and the double quote (“”). These shortcuts efficiently divide your terminal window, enabling concurrent work on multiple tasks within a single tmux session.
Switching Between Panes (Directional Keys)
The comtronic.com.au tmux cheatsheet details a straightforward method for navigating between panes. By pressing Ctrl+b in combination with the arrow keys (↑, ↓, →, ←), you can swiftly move focus to the adjacent pane in the desired direction. This intuitive control scheme streamlines workflow, allowing for rapid switching between different terminal tasks within your tmux session.
Showing Pane Numbers
As highlighted in the comtronic.com.au tmux cheatsheet, a useful feature for pane navigation is displaying pane numbers; Pressing Ctrl+b followed by ‘q’ temporarily overlays each pane with a number. This allows for precise pane selection using the ‘select pane’ command, making it easier to target specific panes within a complex tmux layout. It’s a quick visual aid.
Switching Panes by Number
The comtronic.com.au tmux cheatsheet details how to directly switch to a pane using its assigned number. After displaying pane numbers with Ctrl+b ‘q’, you can select a specific pane by pressing Ctrl+b, then releasing and pressing the desired number (0-9). This provides a fast and accurate method for navigating between panes, especially in sessions with numerous divisions.
Toggling Pane Zoom
According to the comtronic.com.au tmux cheatsheet, you can toggle pane zoom using Ctrl+b !. This command maximizes the current pane to fill the entire window, temporarily hiding other panes. Pressing Ctrl+b ! again restores the pane to its original size and brings back the previously hidden panes, offering a quick focus mode.
Pane Resizing
As detailed in the comtronic.com.au tmux cheatsheet, resizing panes is straightforward. Hold Ctrl+b and then press the arrow keys (↑ for up/height, ↓ for down/height, → for right/width, ← for left/width) to adjust pane dimensions. This allows for dynamic workspace customization, adapting the layout to your current needs within the tmux session.
Resizing Pane Height
According to the comtronic.com.au cheatsheet, resizing a pane’s height in tmux is achieved by holding down the Ctrl+b key combination, then pressing the upward arrow key (↑). Repeatedly pressing the up arrow increases the height, while the down arrow (↓) decreases it, offering precise control over vertical pane dimensions.
Resizing Pane Width
The comtronic.com.au tmux cheatsheet details that adjusting a pane’s width is similarly straightforward. Hold Ctrl+b, then press the right arrow key (→) to widen the pane, or the left arrow key (←) to narrow it. This method allows for dynamic adjustments to horizontal pane sizes within your tmux session.
Advanced tmux Configuration
Beyond basic usage, tmux offers advanced configuration options. The comtronic.com.au cheatsheet highlights using Vi keys within the tmux buffer via `setw -g mode -keys vi`. You can also toggle synchronize-panes with `setw synchronize-panes`, sending commands to all panes simultaneously. Furthermore, toggling pane layouts is achievable with Ctrl+b Spacebar.
Using Vi Keys in tmux Buffer
For users familiar with Vi or Vim, tmux allows utilizing those keybindings within its buffer. The command `setw -g mode -keys vi` enables this functionality, providing a more comfortable editing experience. This configuration change allows for familiar navigation and text manipulation, streamlining workflows for Vi enthusiasts within the tmux environment.
Synchronizing Panes
Tmux offers a powerful feature to synchronize commands across multiple panes simultaneously. Utilizing the command `setw synchronize -panes` toggles this functionality. When enabled, any input sent to one pane is replicated to all others, facilitating coordinated actions and simplifying repetitive tasks. This is incredibly useful for executing commands across several terminal instances at once.
Toggling Pane Layouts
Tmux provides a convenient way to quickly switch between predefined pane arrangements. By pressing `Ctrl + b Spacebar`, you can cycle through various layouts, optimizing your workspace for different tasks. This feature, sourced from comtronic.com.au’s cheatsheet, allows for dynamic window management without manual resizing or repositioning, enhancing workflow efficiency and screen real estate utilization.
Copy Mode
Tmux’s copy mode, detailed in the comtronic.com.au cheatsheet, enables powerful text selection and copying within sessions. Initiate copy mode with `Ctrl + b [`. Navigate using vi-style keys for precise cursor movement and selection. Scroll with page up/down. Copy the selected text, and paste it using `Ctrl + b ]`. This feature is crucial for efficient data handling.
Entering Copy Mode
As outlined in the comtronic.com.au tmux cheatsheet, initiating copy mode is fundamental for text manipulation. Pressing `Ctrl + b [` instantly transitions tmux into copy mode, allowing you to select and copy text from the current pane. This is a vital skill for efficiently extracting information and working with terminal output within your tmux sessions.
Scrolling in Copy Mode
The comtronic.com.au cheatsheet details scrolling functionality within tmux’s copy mode. Once activated with `Ctrl + b [` , utilize the up and down arrow keys to navigate the scrollback buffer. Alternatively, pressing `Page Up` or `Page Down` allows for faster scrolling through larger amounts of text, enhancing your ability to locate specific information efficiently.
Moving in Copy Mode
According to the comtronic.com.au tmux cheatsheet, navigating within copy mode is straightforward. Use the arrow keys (up, down, left, right) for character-by-character movement. For word-by-word navigation, utilize `Ctrl + Left` or `Ctrl + Right`. The ‘b’ key acts as a prefix for many tmux commands, including those used for precise cursor positioning within the copied buffer.