A Perl script controls Tmux configuration
Magical Window
Instead of manually rearranging windows in a development environment time and time again, the Tmux terminal multiplexer can restore them from a configuration script.
If you don't use a development environment such as Eclipse but mostly rely on the command line in a terminal, you will certainly be familiar with screen
. Among other things, this legacy terminal utility ensures that, after network problems, the initiator of an aborted SSH session can continue without problems exactly where they stopped typing. The screen
utility sits between users and applications running in the terminal and tricks the application into believing that an attentive user is still at the keyboard, even if they have long since left the office for a weekend break.
As you know, the Unix world has not stood still over the past 20 years, and a relatively young project named Tmux [2] has been set up to improve and replace Screen. Like Screen, Tmux offers the user several sessions, which in turn comprise windows; in Screen lingo, this does not mean desktop windows, but switchable text interfaces in the same terminal window. Using keyboard shortcuts, Tmux can subdivide each window again by creating vertically or horizontally arranged panes, all of which are visible at the same time (Figure 1).
Tmux runs on all major platforms. If you work on a Linux desktop but use a MacBook on the road, you will find the same windows and panes in both environments.
Servers and Clients
An automatically launched Tmux server keeps track of active sessions, and the user can remotely control them at the command line. The tmux
command creates new sessions or closes them later, adds more windows or deletes them, integrates or removes panes, and scales panes up or down. For developer environments with multiple windows and panes, it makes sense to save the time-consuming configuration in a source code repository and display it again, when needed, with a single command.
Tmux can also launch applications in panes, for example, your favorite editor, which in turn loads a project file. Another pane could start the test suite, and a third could use tail
to display the end of a log file.
Changes Desirable
A newly installed Tmux has some weird keyboard shortcuts. To make sure keystrokes are interpreted by the intermediate terminal multiplexer – and not by the applications running in a Tmux session, like the editor – you need to type what is known as a prefix. A vanilla Tmux installation uses Ctrl+B by default, a keyboard shortcut that not only causes repetitive strain injury with frequent use but also is a common Vi command, and thus a no-go.
Fortunately, Tmux lets you change everything, so experienced users will quickly put together their own .tmux.conf
file after the install; my file is documented in my GitHub repository [3]. It is ultimately only based on general recommendations, such as setting a screen
-compatible prefix with Ctrl+A and using vim
-style combinations for the rest: H=left, J= down, K=up, L=right. This removes the need to enter Emacs-style text commands to toggle between panes; instead, you can use <Prefix> H to go to the left-hand panel.
Of course, customized shortcuts have a couple of drawbacks; for example, everyone speaks a different Tmux dialect and flaps around like a bug on its back in anyone else's environment. However, Tmux understands written commands, introduced with the <Prefix>: keyboard shortcut (prefix followed by a colon), which you type in the opening status line.
Tmux also understands the same commands at the shell prompt, meaning your own scripts for creating a window group can be used globally. For example, the Perl script in Listing 1 issues the
Listing 1
tmux-setup
tmux kill-session
command with the session name log4perl
in line 27, if the user runs the script with the -k
option. The command opens a connection to the Tmux server (if it is running), finds the session, and then winds it up.
Once Only
The -v
(verbose) option tells Listing 1 to set the Log4perl configuration to the $DEBUG
logging level; $INFO
would mean far less talk. To avoid the need for the script to write out every single Tmux command, the tmux()
function in lines 68-74 calls tmux
via the shell. The tap()
function from the CPAN Sysadm::Install module triggers this. Because I wanted to avoid having to use parentheses when calling tmux()
, line 12 declares it as a function in the current namespace.
Line 32 calls source
to parse the configuration file .tmux.conf
from the user's home directory. Tmux should actually do this automatically, but the version I used didn't comply – this looks like a bug. Additionally, in line 36, it uses the tmux has-session
command to discover whether the Tmux session to be established is already running and drops down to attach
in line 64 if the session is running and the script only needs to join it.
If the session is unknown, the new-session
command in line 44 creates a new session named log4perl
. The session name refers to the Log4perl project in whose Git repository it acts as a developer environment. The -d
(detach) parameter at the end of the Tmux command stipulates that the script should not immediately enter the session and display the GUI but wait patiently for the attach
command in line 64 before showing the user anything.
Buy this article as PDF
(incl. VAT)
Buy Linux Magazine
Subscribe to our Linux Newsletters
Find Linux and Open Source Jobs
Subscribe to our ADMIN Newsletters
Support Our Work
Linux Magazine content is made possible with support from readers like you. Please consider contributing when you’ve found an article to be beneficial.
News
-
Gnome OS Transitioning Toward a General-Purpose Distro
If you're looking for the perfectly vanilla take on the Gnome desktop, Gnome OS might be for you.
-
Fedora 41 Released with New Features
If you're a Fedora fan or just looking for a Linux distribution to help you migrate from Windows, Fedora 41 might be just the ticket.
-
AlmaLinux OS Kitten 10 Gives Power Users a Sneak Preview
If you're looking to kick the tires of AlmaLinux's upstream version, the developers have a purrfect solution.
-
Gnome 47.1 Released with a Few Fixes
The latest release of the Gnome desktop is all about fixing a few nagging issues and not about bringing new features into the mix.
-
System76 Unveils an Ampere-Powered Thelio Desktop
If you're looking for a new desktop system for developing autonomous driving and software-defined vehicle solutions. System76 has you covered.
-
VirtualBox 7.1.4 Includes Initial Support for Linux kernel 6.12
The latest version of VirtualBox has arrived and it not only adds initial support for kernel 6.12 but another feature that will make using the virtual machine tool much easier.
-
New Slimbook EVO with Raw AMD Ryzen Power
If you're looking for serious power in a 14" ultrabook that is powered by Linux, Slimbook has just the thing for you.
-
The Gnome Foundation Struggling to Stay Afloat
The foundation behind the Gnome desktop environment is having to go through some serious belt-tightening due to continued financial problems.
-
Thousands of Linux Servers Infected with Stealth Malware Since 2021
Perfctl is capable of remaining undetected, which makes it dangerous and hard to mitigate.
-
Halcyon Creates Anti-Ransomware Protection for Linux
As more Linux systems are targeted by ransomware, Halcyon is stepping up its protection.