tuned-switcher - Man Page
Performance profile manager
Synopsis
tuned-switcher
Description
Tuned Switcher is a simple utility to manipulate the Tuned service.
Tuned is a daemon for monitoring and adaptive tuning of system devices.
In order to use this program, a daemon must be installed on your system.
Application Modes
Available modes
This software can operate in two modes:
- system tray icon (aka applet) - default and recommended mode controlled by the system tray icon;
- GUI application (aka widget) - simplified mode for desktop environments without a system tray support.
Modes auto-selection
If current desktop environment has a system tray support, an applet will be used, otherwise a widget.
This behavior can be overridden using the environment variable.
Using Application
Performance profiles
Profile selection
Use the “Active profile” selector to choose one of the available performance profiles.
The selected profile will be applied immediately and a notification message will be shown.
Automatic profile selection
Use the “Auto-select profile” checkbox to allow the Tuned service to select performance profile for you.
If this checkbox is not available (grayed), this feature is already enabled and in use.
Service control functions
Enable the service
Enable the service and apply the profile optimizations and tweaks from the selected profile.
Disable the service
Disable the service and restore the profile optimizations and tweaks to factory default values.
Reload the service
Reload the service configuration after adding, removing or editing profiles. To refresh the list of available profiles, you will need to restart the program.
Shut down the service
Shut down the service, restore the profile optimizations and tweaks to factory default values, and unload the active profile.
Program Settings
Dialog
The Settings dialog can be used to control over the supported configuration options with a simple and user-friendly GUI form.
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.
- Use sound for notifications – enable or disable using the sound for notifications.
- Run application on startup – enable or disable starting the program on system startup. The service startup should be enabled first.
Press Ctrl+R to reset all settings to default values. A confirmation dialog will be shown.
Config file
The configuration file is located at $HOME/.config/EasyCoding/tuned-switcher.conf.
Command-Line Options
No custom command-line options available.
Environment Options
Environment variables can be used to override some internal program settings for special cases or debugging purposes.
Supported options
- TUNED_SWITCHER_FORCE_GUI=1 - force widget mode even if the system tray support is present.
- TUNED_SWITCHER_DISABLE_SYSTEMD=1 - disable built-in systemd dbus API integration.
- TUNED_SWITCHER_USE_PORTAL=1 - always use the desktop portal even if the application is not sandboxed.
Forwarding options
Export the environment variable using the export command:
export TUNED_SWITCHER_FORCE_GUI=1
Start the application:
tuned-switcher
Startup
Tuned startup
Enable startup of the Tuned service to automatically apply performance profile settings at system boot.
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.
Also, the autorun settings of current desktop environment can be used too.
Localization
Loading translations
The program will try to find and load translations from the following directories:
- translations relative to current binary
- /usr/share/tuned-switcher/translations
- 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.
Authors
Copyright (c) 2021-2026 EasyCoding Team and contributors.