Tmux Terminal Manager (TTM)

Tmux for people who don't do Tmux, integrated into Unraid OS.

Installs Tmux, if not already present on your system, and otherwise uses the existing Tmux.

 

 

Easily open and manage multiple persistent terminal sessions in the Unraid Web GUI.

Leave your terminals and come back at any later time to check on your long-running operations.

This plugin acts as a frontend / GUI to Tmux, so you won't need to interact with Tmux at all.

 

 

Installable via Community Applications

 

 

 

Definitely one of those plugins I didn't know I needed until now. thanks!

Nice work as always Rysz

will be a great utility for lots of folks i suspect

I also think many people will find they do not need this plugin as tmux is automatically installed if necessary by the Unassigned Devices Preclear plugin. 

5 minutes ago, itimpi said:

I also think many people will find they do not need this plugin as tmux is automatically installed if necessary by the Unassigned Devices Preclear plugin. 

 

Not exactly sure what you mean, this is a GUI for/around Tmux and not a Tmux plugin. It will use an existing Tmux installation if there's one (e.g. by the Preclear plugin). Perfectly fine if you don't need it, but it's not "just Tmux", it's a GUI integration for Tmux.

 

28 minutes ago, itimpi said:

I also think many people will find they do not need this plugin as tmux is automatically installed if necessary by the Unassigned Devices Preclear plugin. 

Maybe try it before commenting so you don't completely miss the point

This is great addition!  I was getting failures when trying to create my first session.  To troubleshoot, I opened CLI and tried tmux but got "directory /tmp/tmux-0 has unsafe permissions"

 

I removed /tmp/tmux-0 and then I was able to use the plug-in correctly and create sessions.

Great plugin, normally a screen user but this makes it all too easy 😆

Any chance you could extend the plugin to include a context item for docker containers to start terminal session using tmux?

On 1/1/2025 at 12:49 PM, tjb_altf4 said:

Great plugin, normally a screen user but this makes it all too easy 😆

Any chance you could extend the plugin to include a context item for docker containers to start terminal session using tmux?

 

I can take a look, what would be your use case to keep open a persistent terminal session into a Docker container?

1 hour ago, Rysz said:

 

I can take a look, what would be your use case to keep open a persistent terminal session into a Docker container?

Mostly starting and monitoring long running computational jobs in custom built dockers.
I guess there would need to be some logic to open existing session or create new, but for my use case I would only ever want a single session (and to resume if exists).

To be honest, most of the appeal is not having half a dozen separate terminal browser windows open while getting CLI work done (I love the group window / settings page viewer)

@tjb_altf4: I haven't had time to check out the Docker terminal yet, I'm afraid, hopefully I'll get to it in the next weeks.

But I've just added the setting to kill array-accessing sessions when the array stops, which would otherwise block array shutdown.

Very impressive, nice intuitive GUI, love the small previews, and good help descriptions for the available options. This basically is as simple as "terminals in tabs" and it works great and does not require any knowledge of tmux. Thanks for Rysz putting a screenshot in the OP in this thread.

 

Feature request; for those willing to adopt tmux this way:

Add a Help option with a tmux shortcuts cheetsheet.

Maybe with a note saying these are not actually required to use this plugin TTM, but allow connecting to these sessions from other tty consoles / cli terminals. For example allowing people to check on progress/status using Putty on a laptop, the default Unraid Terminal, or even a SSH phone app.

18 minutes ago, Barry Staes said:

Very impressive, nice intuitive GUI, love the small previews, and good help descriptions for the available options. This basically is as simple as "terminals in tabs" and it works great and does not require any knowledge of tmux. Thanks for Rysz putting a screenshot in the OP in this thread.

 

Feature request; for those willing to adopt tmux this way:

Add a Help option with a tmux shortcuts cheetsheet.

Maybe with a note saying these are not actually required to use this plugin TTM, but allow connecting to these sessions from other tty consoles / cli terminals. For example allowing people to check on progress/status using Putty on a laptop, the default Unraid Terminal, or even a SSH phone app.

 

Thanks a lot for the nice words, Barry!

Great idea and timing of your post too, as I was just working on an update and this is now included. 🙂 

Impressive! Got this notification in Unraid minutes after posting here..

Quote

Tmux Terminal Manager TTM: An update is available.Click here to install version 2025.01.11

 

Installed and works OK!
Using Unraid 7.0.0-rc2 (release candidate) , and started the update while tmux sessions are running. All good.

Just installed this plugin and I’m seeing a warning that I have a custom instance of TMUX already running on my system. Not sure if this is an issue or not or even how/when TMUX got installed.

10 minutes ago, wgstarks said:

Just installed this plugin and I’m seeing a warning that I have a custom instance of TMUX already running on my system. Not sure if this is an issue or not or even how/when TMUX got installed.

 

It's not a problem, the plugin is designed to use an existing Tmux installation if one is present. It's likely there as part of the Preclear plugin, if you have that installed, or you installed it via NerdTools at some point. In any case, it's not a problem. 🙂 

 

21 minutes ago, Rysz said:

 

It's not a problem, the plugin is designed to use an existing Tmux installation if one is present. It's likely there as part of the Preclear plugin, if you have that installed, or you installed it via NerdTools at some point. In any case, it's not a problem. 🙂 

 

Thanks

What a handy plugin, nice work!, i am a screen/tmux user myself but this makes it even nicer to interact with the sessions, love the preview window very cool. One minor feature request - can you please make it so that if you double click on a session window it puts you into title edit mode?, i see where the title goes but its small and I'm lazy 🙂, would be great to just double click anywhere on the window to edit the title, other than that for me its perfect!.

 

Edit - Just to be clear as i see there are two ways to use this plugin, im talking about editing the title of the session through Settings/Tmux Mamanger and then each session window, NOT when clicking on the Tmux Terminal Manager icon.

Sorry another feature request - any chance of having a dropdown in settings for the plugin to allow you to set the default action to be Quick Session/New Session/Both?, use case is i nearly always see myself using quick session, so would love to set that as the default, one less click - told ya i was lazy :-).

Thanks for the nice words and feedback, I'll put it on the TO-DO list. 🙂 

Cool plugin! Can I use my own tmux config with this (maybe with tpm)? Where would I put that file and persist it between restarts?

On 2/2/2025 at 6:03 PM, mangocrysis said:

Cool plugin! Can I use my own tmux config with this (maybe with tpm)? Where would I put that file and persist it between restarts?

 

You can use your own Tmux configuration, TTM doesn't interact with the configuration file any more than Tmux does.

You could write a script with e.g. User Scripts that replaces the file in /etc/tmux.conf on boot, or uses sed/awk to patch it.

I am getting this message below my Tmux screen:

 

A custom Tmux installation was detected on your server, so the plugin did not install its own over it.
If you are running into unexpected behavior, consider removing the custom Tmux installation from your system.
After a plugin reinstall or reboot, a functional Tmux installation (that is tailored to your OS version) will be reinstalled.

 

Not sure what other installation it is detecting because I have installed Tmux from the communtiy apps store.

 

I did a whereis tmux in terminal and this is what came up:
tmux: /usr/bin/tmux /usr/man/man1/tmux.1.gz

Edited February 15, 20251 yr by remati

1 minute ago, remati said:

I am getting this message below my Tmux screen:

 

A custom Tmux installation was detected on your server, so the plugin did not install its own over it.
If you are running into unexpected behavior, consider removing the custom Tmux installation from your system.
After a plugin reinstall or reboot, a functional Tmux installation (that is tailored to your OS version) will be reinstalled.

 

Not sure what other installation it is detecting because I have installed Tmux from the communtiy apps store.

 

I did a whereis tmux in terminal and this is what came up:
tmux: /usr/bin/tmux /usr/man/man1/tmux.1.gz

 

It's possible you have the Preclear plugin installed (which includes Tmux), anyway it's not a problem - it's just an information in case something doesn't work.