PowerTuner gamepad first, touch friendly, client for handhelds and couch gaming.
For a command-line client, see PowerTunerCLI
For a classic desktop client, see PowerTunerClient
Go to Daemons tab and connect to local daemon, or add a new daemon if you installed the daemon/service in another device and want to connect to it.
A gamepad or a keyboard is required to control its UI, mouse is not supported and wont work for some parts of it.
Use the desktop client for a classic mouse/keyboard UI.
PowerTunerConsole implements Text To Speech, which is enabled by default.
When enabled, section titles are focusable, so they can be spoken, but without focus effect.
TTS can be disabled in Settings tab.
No setup is required in Windows.
If your distro does not come with TTS pre-configured, you must install the required packages yourself.
Please check your distro wiki.
Known working setups:
ArchLinux
Install the required packages
sudo pacman -S speech-dispatcher espeak-ng espeakupstart and enable speech-dispatcher systemd service.
see ArchLinux speech-dispatcher wiki for more info.
The app can be controlled with both, keyboard and gamepad.
Please note that key combos are not available when using a keyboard.
This is a gamepad first UI, keyboard controls were made available for easy of development or as a fallback in rare cases.
Keyboard controls remap is available in Settings tab, it does apply to all connected keyboards.
Default mapping
Previous tab F1
Next tab F2
Left Left arrow
Fast left < (angle bracket, less-than)
Right Right arrow
Fast right > (angle bracket, greater-than)
Up Up arrow
Down Down arrow
Click X
Back ESC
Reload values from daemon F5
Apply current settings F6
Input mode switch T
Scroll up J
Scroll down K
Scroll left N
Scroll right M
Scroll page up PageUp
Scroll page down PageDown
Scroll page to top F3
Scroll page to bottom F4
Gamepad support is provided by latest SDL.
Default mapping
Previous tab L1
Next tab R1
Left Dpad left
Fast left L2
Right Dpad right
Fast right R2
Up Dpad up
Down Dpad down
Click A (XBOX) / X (Playstation) / B (Nintendo)
Back B (XBOX) / O (Playstation) / A (Nintendo)
Reload values from daemon Start
Apply current settings Select
Input mode switch Y (XBOX) / /\ (Playstation) / X (Nintendo)
Scroll up Left analog up
Scroll down Left analog down
Scroll left Left analog left
Scroll right Left analog right
Scroll page up Right analog up
Scroll page down Right analog down
Scroll page to top Right analog left
Scroll page to bottom Right analog right
Show/Hide client combo L1 + Dpad down + (X (XBOX) / [ ] (Playstation) / Y (Nintendo))
3rd party controllers, and unofficial controllers, may have different face buttons
In addition, SDL GameControllerDB is built-in and loaded on boot.
You can override the built-in GameControllerDB by creating or editing the file
<powerTuner client folder>\sdl_gamepad_db.txt
Replace <powerTuner client folder> with PowerTunerConsole data path, which is printed in Log tab on boot.
Usually, the path should be:
Windows:
C:\Users\<username>\AppData\Local\PowerTuner\console
Linux:
/home/<username>/.local/share/PowerTuner/console
If you have run PowerTunerConsole at least once, that file already exists and it is a copy of the loaded built-in database.
If this file is not found, the built-in GameControllerDB will be loaded and written to that file.
Reload gamepad mappings from Settings tab to apply the changes immediately.
Gamepad controls remap is available in Settings, each gamepad has its own mapping.
PowerTunerConsole can be used as an overlay app, that is, it is a always on top window.
Change Application quit behaviour in Settings to either Floating icon or Close to tray.
This allows to show/hide PowerTunerConsole window with a gamepad combo (Application button combo in Settings).
You may need to set games/apps window to something different than Exclusive fullscreen, since it may not allow PowerTunerConsole to be shown on top.
Floating icon can be moved everywhere in your screen.
Left mouse click: show PowerTunerConsole
Left mouse hold: move the icon
Right mouse click: quit PowerTunerConsole
A gamepad controlled micro keyboard is available and automatically shown on text input activation.
Micro keyboard is the best option for these cases, easy to use, gamepad friendly and does not hide big chunks of the UI.
MicroKeyboard uses the gamepad mapping you have set, in Settings, for the gamepad controlling it.
Reported here, are the labels of the mapping, as found in Settings, not the actual keys.
Left: Previous
Fast left: Previous (5 steps)
Right: Next
Fast rigth: Next (5 steps)
Scroll up: Anchor MicroKeyboard to up corner from current corner
Scroll down: Anchor MicroKeyboard to bottom corner from current corner
Scroll left: Anchor MicroKeyboard to left corner from current corner
Scroll right: Anchor MicroKeyboard to right corner from current corner
Input mode switch: Lowercase/Uppercase
Previous tab: Send backspace key
Next tab: Send delete key (clear input text)
Click: Send selected key
Back: Close micro keyboard
Special MicroKeyboard keys:
[ ]: Space
RET: Return (enter key)
This is a special action you can activate on sliders, when they are focused, that allows to switch between a slider input or text input, depending on your needs.
Wayland lacks support for some features, either as a design choice, or still not implemented, experience may not be on par with X11.
Floating icon will never work on wayland because it wont allow applications to control their windows, use tray icon instead.
Applications are not allowed to put themselves on top of other windows, the "overlay mode" may not work as expected.
clone this repo:
git clone --recursive https://github.com/PowerTuner/PowerTunerConsole.gitBuild options:
WITH_INTEL
enable building of client UI for Intel CPU settings, default ON
WITH_AMD
enable building of client UI for AMD CPU settings, default ON
requirements:
- gcc or clang
- cmake
- qt6-base
- qt6-speech
$ cd PowerTunerConsole
$ cmake -B build -DCMAKE_BUILD_TYPE=Release
$ make -C build
requirements:
- Visual Studio 2022 with the component Desktop development with C++ installed
- Windows terminal
- latest Qt with MSVC 2022 64bit installed
Open terminal and create a new instance of Developer Command Promp for VS 2022 or Developer PowerShell for VS 2022.
Tab completition feature is only available in PowerShell
$ cd PowerTunerConsole
$ cmake -B build -DCMAKE_BUILD_TYPE=Release -DCMAKE_PREFIX_PATH="<path to Qt>\msvc2022_64\lib\cmake" -G "Ninja"
$ ninja -C build
Replace <path to Qt> with your Qt root path, default is C:\Qt\<Qt version>
Some settings like TDP or GPU clock, use a json database with min/max ranges.
Built-in ranges are safe, not exceeding the default/recommended values for the device.
To create your own ranges override, see instructions here.
Linux Intel device screenshot
