G-Helper for macOS - ASUS laptop menu-bar app and kext for performance modes, fans, keyboard RGB, charge limit, and Eco mode
Alternative Implementations
MHelper is a menu-bar app and an OpenCore kext. The app needs the kext loaded at boot. It does not require Lilu.
MHelper is the G-Helper equivalent for macOS on ASUS laptops. It is a small menu-bar app backed by a kext that talks to the same firmware interface as Linuxโs asus-wmi driver and G-Helper on Windows.
Overview
ASUS laptops expose performance modes, fan control, keyboard lighting, battery charge limits, and other hardware features through ASUS WMI (WMNB on the ATKD ACPI device). MHelper drives those features from a menu-bar app, with a companion kext loaded through OpenCore. It works alongside or instead of AsusSMC.
The app only shows what your laptopโs firmware reports, so it adapts to each model. Settings are reapplied at login and after sleep.
Features
| Area | What it does |
|---|---|
| Performance | Silent / Balanced / Turbo modes |
| Fans | Live CPU, GPU, and mid-fan RPM; custom fan curve per fan and mode |
| Keyboard | Brightness 0โ3; RGB colour (wheel, hex, swatches); Static / Breathing / Colour cycle / Strobe; lit while asleep; save to firmware |
| Fn keys | Media, screen and keyboard brightness, touchpad, sleep, Fn+F5 mode, Fn+F4 Aura effect, Fn lock |
| Battery | Charge limit (60 / 80 / 100 %) |
| Display & GPU | Panel overdrive; Eco mode (NVIDIA dGPU off) |
| System | Fn lock, boot sound |
| ROG / TUF mice | DPI slots, polling rate, angle snapping, per-zone lighting, button bindings; battery and power options on supported models (no kext needed) |
TUF keyboards are driven through the firmware; ROG keyboards over USB. ROG/TUF mouse support covers 67 models from G-Helperโs list.
Requirements
- macOS 13 Ventura or newer (Intel/AMD Hackintosh, x86_64).
- An ASUS laptop with the
ATKDACPI device โ every recent ASUS laptop has it. - OpenCore, to load the kext at boot.
Installation
1. The kext
Automatic: run sudo Extras/install.sh. It finds your OpenCore EFI, copies MHelper.kext to EFI/OC/Kexts, adds it to config.plist (backup: config.plist.pre-mhelper), and asks you to restart. sudo Extras/uninstall.sh switches it off again. If OpenCore is on more than one drive, it lists them and asks which one.
By hand:
- Copy
MHelper.kexttoEFI/OC/Kexts/. - In
config.plist, add to Kernel โ Add withBundlePathMHelper.kext,ExecutablePathContents/MacOS/MHelper,PlistPathContents/Info.plist,MinKernel22.0.0, andEnabledtrue. ProperTreeโs OC Snapshot adds it for you. - Reboot.
To try it first without touching your EFI (needs unsigned kexts allowed, for example csr-active-config 0x03; it is gone after a reboot):
sudo Extras/load.sh
2. The app
Move MHelper.app to Applications and open it. The app is not notarised: the first time, right-click it โ Open โ Open, or run:
xattr -dr com.apple.quarantine /Applications/MHelper.app
It lives in the menu bar (no Dock icon). Tick Open at login in its panel.
Command Line
The bundled mhelper tool does the same from Terminal:
mhelper # status
mhelper mode silent|balanced|turbo
mhelper kbd 0-3
mhelper color ff8800 [static|breathe|cycle|strobe] [0-2] [--save]
mhelper charge 80
mhelper overdrive 0|1
mhelper eco 0|1 # 1 = NVIDIA dGPU off
mhelper fnlock 0|1
mhelper curve cpu|gpu|mid [silent|balanced|turbo]
Command-line fan curves last until the kext unloads or the laptop restarts; the app saves its own and sets them again at login.
Fn Keys and AsusSMC
With AsusSMC loaded, it keeps the Fn keys and MHelper leaves them alone. To use MHelperโs own Fn keys (Fn+F5 mode, Fn+F4 Aura, keyboard light, and the rest), remove AsusSMC from your EFI. sudo Extras/asussmc.sh off switches its config entry off; on brings it back.
Safety
- Loading MHelper changes nothing. It only reads which features the firmware has; every change comes from you.
- Colours are not stored in the firmware unless you choose Save to firmware (or
--save): a reboot undoes any experiment. - Eco mode powers the NVIDIA GPU off at firmware level. It stays off, also in Windows, until you turn Eco off again; a reboot may be needed for it to come back. MHelper refuses Eco while the GPU MUX is in dGPU-only mode, like Linux does.
- MHelper never changes the GPU MUX (dGPU-only would mean a black screen in macOS) and does not touch CPU/GPU power limits.
- Fan curves are yours to get right: too little fan at high temperatures can overheat the laptop. Use firmware curve undoes a custom one.
Related Kexts
- AsusSMC - Alternative ASUS Fn-key and backlight driver
- OpenCore - Required bootloader for the MHelper kext
- VirtualSMC - SMC emulation used by most ASUS laptop builds