10 Customization
NGnius edited this page 2024-05-05 02:47:31 +01:00

As of v1.1.0, PowerTools supports customizing values for most functionality. This can be useful for advanced uses like overclocking or untested hardware. Please remember that the terms of the license place all responsibility on the user to use these features responsibly.

As of v2.0.0, the same customization file is used for all devices.

NOTE: Advanced features are meant to be used by advanced users. Advanced users are expected to be able to figure this out without dev intervention.

Limits Override

There is an optional file limits_override.ron RON file which will override the default limits chosen by PowerTools for various components. This file must be placed in ~/homebrew/settings/PowerTools (the same folder which contains settings profiles). Any file error will be logged to the main PowerTools log location and the limits override file will be ignored. Some effort is made to keep this file consistent between updates, but major and minor updates may introduce incompatibilities.

The file structure base is defined in limits.rs (the immediate folder contains more specific parts) and a generated RON sample file is in limits_override.ron. If you do not understand these files, please do not use this feature. These files reuse the limits server data structures, so all types and names directly correspond to their respective default limit.

NOTE: some kernel interfaces only accept the default ranges (especially for Steam Deck) so changing certain ranges is only a placebo in the UI. Logs will likely show when this is happening.