MHelper

MHelper

by FranciumOS-org
Utilities ASUS

G-Helper for macOS - ASUS laptop menu-bar app and kext for performance modes, fans, keyboard RGB, charge limit, and Eco mode

Advertisement
Advertisement
App + kext

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 ATKD ACPI 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:

  1. Copy MHelper.kext to EFI/OC/Kexts/.
  2. In config.plist, add to Kernel โ†’ Add with BundlePath MHelper.kext, ExecutablePath Contents/MacOS/MHelper, PlistPath Contents/Info.plist, MinKernel 22.0.0, and Enabled true. ProperTreeโ€™s OC Snapshot adds it for you.
  3. 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.
  • AsusSMC - Alternative ASUS Fn-key and backlight driver
  • OpenCore - Required bootloader for the MHelper kext
  • VirtualSMC - SMC emulation used by most ASUS laptop builds

Resources