tuned-switcher(1)

💖 tuned-switcher(1) — the General Commands Manual glow-up ✨

okay bestie, gather round, because we're reading the tuned-switcher(1) page together and it's lowkey iconic 🎀

---

🌸 NAME 🌸

tuned-switcher — your performance profile manager, periodt 💅

---

✨ SYNOPSIS ✨

tuned-switcher

that's it. that's the whole vibe. no flags, no drama, just run it 🦋

---

🫶 DESCRIPTION 🫶

Tuned Switcher is a simple little utility whose whole job is manipulating the Tuned service. no cap, that's the mission 🌈

Tuned itself is a daemon — a background service that monitors and adaptively tunes your system devices. it's giving "silent main character energy" fr fr 👑

and here's the thing, babe: to use this program, a daemon must be installed on your system. non-negotiable, no exceptions, sorry not sorry 😭

---

🎀 APPLICATION MODES 🎀

💜 Available modes

this software can operate in two modes, and yes you have to pick one:

• system tray icon (aka applet) — the default and recommended mode, controlled by the system tray icon. this is the one, iykyk ✨
• GUI application (aka widget) — a simplified mode for desktop environments that don't have system tray support. it's the backup bestie 🫶

🦋 Modes auto-selection

if your current desktop environment has system tray support, an applet gets used. otherwise? widget. automatic. slay 💅

this behavior can be overridden using the environment variable (more on that below, keep scrolling 🌸)

---

🔥 USING APPLICATION 🔥

⭐ Performance profiles

👑 Profile selection

use the “Active profile” selector to choose one of the available performance profiles.

the selected profile gets applied immediately and a notification message will be shown. instant gratification, we love to see it 💖

🌈 Automatic profile selection

use the “Auto-select profile” checkbox to let the Tuned service pick a performance profile for you. letting the daemon be the main character for once 🙈

if this checkbox is not available (grayed out), that means the feature is already enabled and in use. it's not broken, bestie, it's just already doing the thing 😌

💅 Service control functions

✅ Enable the service

enable the service and apply the profile optimizations and tweaks from the selected profile. go time 🔥

🚫 Disable the service

disable the service and restore the profile optimizations and tweaks to factory default values. we're resetting the vibe to stock 🌱

🔄 Reload the service

reload the service configuration after adding, removing or editing profiles.

⚠️ heads up: to refresh the list of available profiles, you will need to restart the program. the reload alone won't update that list, so don't come for me when it looks stale 😭

💀 Shut down the service

shut down the service, restore the profile optimizations and tweaks to factory default values, and unload the active profile. it's giving "closing all the tabs at once" energy ✨

---

🎀 PROGRAM SETTINGS 🎀

🖥️ Dialog

the Settings dialog can be used to control the supported configuration options with a simple and user-friendly GUI form. no terminal gymnastics required, bestie 💜

⚙️ Program settings

the following settings can be configured via the graphical user interface:

• Save and restore form geometry — enable or disable saving and restoring the size and position of the application forms. ⚠️ disabling this option will delete all saved geometry settings. that's the receipts, gone, poof 💀
• Use sound for notifications — enable or disable using the sound for notifications. quiet mode or full ringtone, your call 🔔
• Run application on startup — enable or disable starting the program on system startup. the service startup should be enabled first tho, so handle that before this one 🫶

press Ctrl+R to reset all settings to default values. a confirmation dialog will be shown first, so no accidental chaos 🙈

📁 Config file

the configuration file lives at $HOME/.config/EasyCoding/tuned-switcher.conf. that's home, babes 🏠

---

✨ COMMAND-LINE OPTIONS ✨

no custom command-line options available. zero. nada. the CLI is on a break and honestly? respect 💅

---

🌈 ENVIRONMENT OPTIONS 🌈

environment variables can be used to override some internal program settings for special cases or debugging purposes. for when you need to break the rules a little 😌

🌸 Supported options

• TUNED_SWITCHER_FORCE_GUI=1 — force widget mode even if the system tray support is present. widget mode, no matter what 🦋
• TUNED_SWITCHER_DISABLE_SYSTEMD=1 — disable built-in systemd dbus API integration. systemd, you're on mute 🔇
• TUNED_SWITCHER_USE_PORTAL=1 — always use the desktop portal even if the application is not sandboxed. portal, always, even when nobody asked 🌀

📤 Forwarding options

export the environment variable using the export command:

export TUNED_SWITCHER_FORCE_GUI=1

start the application:

tuned-switcher

and that's the whole ritual ✨

---

⭐ STARTUP ⭐

🧚 Tuned startup

enable startup of the Tuned service to automatically apply performance profile settings at system boot. set it and forget it, queen 👑

if the system supports systemd, it can be done using the systemctl tool:

sudo systemctl enable --now tuned.service

🚀 Application startup

to enable program startup, just open the Settings dialog and set the Run application on startup checkbox. one click, done 💖

also, the autorun settings of your current desktop environment can be used too — whatever works for your setup, bestie 🫶

---

💜 LOCALIZATION 💜

🌍 Loading translations

the program will try to find and load translations from the following directories:

1. translations relative to current binary
2. /usr/share/tuned-switcher/translations
3. hard-coded fallback path /usr/share/tuned-switcher/translations

starting with the first, the program will attempt to traverse all directories down to the last one. if a directory exists, it will be used for loading translations. if no directories exist, the function will be disabled. that's it, that's the search party 🔍✨

---

👑 AUTHORS 👑

Copyright (c) 2021-2026 EasyCoding Team and contributors.

---

and that's a wrap on the tuned-switcher(1) page from the General Commands Manual 💖 ty for reading the whole thing, bestie, you literally ate and left no crumbs 🎀✨💅