Caution
- Caution: Avoid using
UXTU4Unix
in conjunction with SMCAMDProcessor due to potential conflicts. - This project does not serve as an alternative to SMCAMDProcessor, NootedRed, or AMDPlatformPlugin for CPU/APU power management.
Note
- Compatible with AMD Ryzen APUs supported by either NootedRed or the Premade Preset section in UXTU (or generally supported by RyzenAdj).
- Operating Systems: macOS 10.9 through 15, and Linux (tested on Debian-based distributions, Fedora, AlmaLinux, Alpine, Arch, CentOS, Mint, openSUSE, Pop!_OS, RHEL, Rocky, Stream, SUSE).
- Disable
Secure Boot
in the BIOS. (Unknown: Applying the Secure Boot certificate to UEFI may enable compatibility.) - Download the official build from the Releases.
- Run
UXTU4Unix.command
(macOS only) or runUXTU4Unix.py
using the command:python3 /path/to/UXTU4Unix.py
orpython /path/to/UXTU4Unix.py
. - Follow the on-screen instructions.
- [macOS only] For enhanced temperature management and control with
UXTU4Unix
, disableCore Performance Boost
in the BIOS using Smokeless_UMAF. Note that this may significantly reduce CPU performance, as theCore Performance Boost
feature on macOS is not optimal.
- The binaries (ryzenAdj and DirectHW) are flagged as untrusted kexts in macOS. To ensure functionality, it is necessary to disable SIP and include the
ALLOW_UNTRUSTED_KEXTS
flag (0x1).
- During the transition of AMD APU presets from
UXTU
toUXTU4Unix
, some commands were incompatible with ryzenAdj.UXTU
employs various methods to modify CPU/APU settings beyond those supported by ryzenAdj, particularly concerning CPU presets. Consequently, only select commands were retained as workarounds.
- The release of the GUI is forthcoming, as communicated by NotchApple1703.
For more detailed configurations, please refer to Custom.md.
- Special thanks to b00t0x for guidance on building ryzenAdj based on DirectHW and pciutils-osx.
- JamesCJ60 for contributions to UXTU.
- corpnewt for the command file on macOS.
- NotchApple1703 for the GUI (starting from
0.4.x
).