Warning
- With the end of Hackintosh support in macOS 26 Tahoe, UXTU4Unix
v0.3.4
will be the last version to support macOS. After that, we will shift our focus solely to Linux untilUXTU
officially supports Linux.
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
).