Tuneperf - System orchestration and performance tuning

seb3773 · 2026-09-02 13:06

Hello again!

TunePerf is a system orchestration and performance tuning Bash script +tqt3 GUI for Linux.

Unlike the myriad of copy-pasted scripts found on GitHub (which blindly apply obsolete sysctl values) or heavy background daemons, TunePerf is designed with surgical precision and prudence: it scans the complete hardware topology of your machine to generate tailor-made kernel, hardware, and init-system parameters. It applies them in a "One-Shot" manner, leaving absolutely no resident process behind.

Philosophy
No Resident Daemon: "Performance shouldn't cost performance" ^^ Tools like tuned or tlp add a background process (often Python-based) that continuously polls the system. TunePerf configures the hardware, the kernel, and the system limits at boot, and then gracefully exits.
Context-Awareness: The optimal parameters for a 2GB RAM VPS are radically different from those for a 128GB NUMA Database server. TunePerf scales everything (backlogs, dirty bytes, queue depths) dynamically based on actual hardware capacity.
Safety-First: No risky parameters are enabled by default. Every generated kernel key is dynamically checked against the host's kernel version (sysctl -n) before being applied.
Absolute Reversibility: Every execution of the script generates a fully timestamped backup of the previous system state. The --restore flag allows for an atomic rollback.

Graphical User Interface (GUI)
TunePerf includes a comprehensive graphical desktop client (tuneperfs-gui) to configure policies, profiles, scheduler weights, and service overrides interactively.

Key GUI Features
Fully Autonomous: The GUI embeds the backend tuneperf.sh script, custom icons (compressed via zx0em), and multi-language translations (German, French, Spanish, Italian, Polish, and English) inside a single, zero-dependency executable. The script and the GUI are fully independent; you only need to deploy what you intend to use.
System Language Auto-Detection: Automatically detects the system locale (e.g., fr, de, es, it, pl) at boot and loads the correct translation, falling back to English if the locale is not supported.
No Root Startup Required: Runs securely under your normal user session and presents a privilege dialog only when applying optimizations or interacting with the service backend.

More info on differents features, including the often neglected details that matter here : https://github.com/seb3773/tuneperf

-- -- -- -- --- -- -- -- --- -- -- -- ---- -- -- -- -- --- -- -- -- --- -- -- -- ----
.deb package and .qsi packages provided for easy installation:

https://seb3773.github.io/tuneperf/

-- -- -- -- --- -- -- -- --- -- -- -- ---- -- -- -- -- --- -- -- -- --- -- -- -- ----
*This application is not specific to TDE or Q4OS, but I think it has its place here for two reasons:
- The GUI is 100% TQt3, so it remains a 'native' TQt3 application
- The tweaks/optimizations/adjustments naturally work perfectly with Q4OS (TDE or Plasma) as well as with most other Linux distributions

Some screenshots:

Last edited by seb3773 (2026-09-03 11:24)

bin · 2026-09-06 16:53

@seb3773 This looks like a pretty awesome bit of work. Not sure I've go the nerve to run it on a live box - does it work in a VM?

Sideways question. The forky release of Q4OS 7 TDE is a while away. The one big issue for me seems to have been fixed in TDE 14.1.6 - which I don't think we'll see in Q4OS. It's .pdf file thumbnails - I really rely on these. It may be enough to get me back to TDE from Plasma on some of my systems but the issues with separate screen mirroring mean I have to keep plasma on one I use for presentation work.
You've done a lot of amazing stuff and what I wonder is whether all your various enhancements will run on Trinity Desktop upstream 14.1.6? If so I can install a new drive with 14.1.6 for a while till Q4OS catches up.

seb3773 · 2026-09-06 17:20

bin wrote:

Not sure I've go the nerve to run it on a live box - does it work in a VM?

Yes, it works on any "normal" Linux system, so also in a VM—I actually use it myself to configure some Linux VMs ^^
In any case, I’ve done my best to make the tool as reliable as possible since I use it on my own machines, and everything is reversible, so nothing terrible should happen tongue

bin wrote:

I wonder is whether all your various enhancements will run on Trinity Desktop upstream 14.1.6? If so I can install a new drive with 14.1.6 for a while till Q4OS catches up.

Yes, I can try to check that in detail, but as far as I know, nothing should be really dependent on Q4OS specifically. Most of my applications are now coded in TQt3 for TDE, so I think everything should work fine, either with Q4OS Trinity versions or "only" Trinity installations.

...When I say that most of my applications are now coded in TQt3... I should probably say that all my latest and future applications are, rather ^^
The first reason, of course, is that I’m a Q4OS Trinity user, but actually, I’ve enjoyed learning TQt3 and coding with this graphical framework so much that everything I produce now—anything with a graphical interface—is in TQt3. This doesn’t pose any "universality" issues if I want to use it on another distro: I just need to statically link what’s necessary from TQt3 or create an AppImage.
The TQt3 libraries are so lightweight compared to current standards (GTK4/Qt6, etc.) that even when bundled, the resulting binary sizes remain perfectly reasonable. (Just compare an AppImage of a TQt3 app with an AppImage of the same or equivalent app in GTK or others—it’s quite striking.)

Last edited by seb3773 (2026-09-07 00:58)

bin · 2026-09-07 07:07

smile thanks

Q4OS Forum

#1 2026-09-02 13:06

Tuneperf - System orchestration and performance tuning

#2 2026-09-06 16:53

Re: Tuneperf - System orchestration and performance tuning

#3 2026-09-06 17:20

Re: Tuneperf - System orchestration and performance tuning

#4 2026-09-07 07:07

Re: Tuneperf - System orchestration and performance tuning

Board footer