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:

  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.

Authors

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

Info

General Commands Manual