Warning
- With the end of Hackintosh support in macOS 26 Tahoe, UXTU4Unix
v0.4.x
series will be the last version to support macOS. After that, we will shift our focus solely to Linux untilUXTU
officially supports Linux. - Warning (macOS): Avoid using
UXTU4Unix
in conjunction with SMCAMDProcessor due to potential conflicts.
- 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 26, and Linux (with
upower
andlibpci
installed).
- 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] 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.
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.