This is a Crankshaft plugin that provides control over various power settings such as TDP in handheld devices in Linux. We utilize the RyzenAdj utility to interface with the hardware.
11/30/2022: Currently HandyPT is not able to be used. The underlying plug-in framkework, Crankshaft, no longer loads into the gamepadui. There is currently no ETA for a fix as the primary developer has not been active since late July. In the meantime, there are a few less ideal solutions to managing TDP on these devices.
I will not be providing support for these methods. Currently I am working on getting these features added to decky-loader. As they won't accept HandyPT as a plugin I am working with the PowerTools developer to bring this feature set to that plugin, so watch for that development.
Click this video:
We currently support devices with the following APU's:
While any APU can theoretcally be utilized, the safe operating limits need to be defined before support can be included. If you dont see you device listed head over to our issues page to request support.
We test each release on ChimeraOS. Any distro that supports flatpak, gamescope, and wayland should be able to use this with the DeckUI. Head over to the issues page if your distro has issues and we'll work to get more broad support.
There are two install methods, both require a little bit of command line.
Install crankshaft: https://crankshaft.space/
flatpak install -y flathub space.crankshaft.Crankshaft
flatpak run space.crankshaft.Crankshaft
sudo pacman -Sy glibc
For manual installs you will need the wget package: sudo pacman -Sy wget
Get Plugins
, then click Install
on the Handheld Power Tools
entry.ctrl+alt+f2
and run sudo sh ~/.var/app/space.crankshaft.Crankshaft/data/crankshaft/plugins/HandyPT/bin/configure.sh
This is licensed under GNU GPLv3.
No guarentee is given by the author that this tool will not damage your device, and your voluntary use of this tool forgoes any liability for damage that may come from this tool, irrespective of its intended use. Use at your own risk. This tool is not officially licensed by or directly associated with AYA NEO, OneXPlayer, or any of their employees.
I do. If you like what we have produced here and would like to provide support, you can find me here