Skip to content

Installing HMG API

github-actions[bot] edited this page Nov 1, 2026 · 6 revisions

Installing HMG-API

Takes about 10 minutes. Park the car and keep it on (the head unit restarts once).

Which download? Get it from the Releases page:

You have Use Steps
Nothing installed, no computer hmgapi-<version>-usb.zip USB stick
NEMESIS hmgapi-<version>-nemesis.zip NEMESIS
A computer with adb hmgapi-<version>-adb.zip adb

All three install the same thing, and uninstalling puts every file back exactly as it was.

USB stick

  1. Unzip hmgapi-<version>-usb.zip onto an empty USB stick (FAT32), at the top level.
  2. Plug the stick into the car's USB port.
  3. Open Engineering Mode → USB Copy → DSP → Update OTA. The screen shows "HMG-API … installing", then "HMG-API installed, restarting". Error 684 on the OTA screen afterwards is expected: nothing is undone.
  4. Take the stick out once the head unit has restarted.

What happened is written to HMGAPI/install.log on the stick.

NEMESIS

  1. Unzip hmgapi-<version>-nemesis.zip onto the top level of a USB stick (FAT32 or exFAT), the same way as NEMESIS's own packages: the stick gets NEMESIS.data, packages/hmgapi.zip and a README. Only one NEMESIS package on the stick at a time.
  2. Plug it in once Android is up, and confirm the install of "HMG-API".
  3. Restart the head unit when it says so, and take the stick out.

Updating through NEMESIS later keeps your mods.

adb

unzip hmgapi-<version>-adb.zip
cd hmgapi-<version>-adb
./hmgapi-adb.sh install

Then restart the head unit. The first install needs root from NEMESIS.

After installing

No HMG-API tile in the app menu? The tile and the ★ choice are added by HMG-API's hooks, so a car without a hook map yet doesn't get them. Open the app from NEMESIS Manager → My Packages → HMG-API → Launch instead, or over adb: adb shell hmgapid sh 'sh /data/hmgapi/open.sh'. Both install the app first if it's missing.

Open HMG-API from the app menu (or put it on a ★ key). The bar at the top says whether HMG-API's hooks are on for your car:

  • Hooks on: everything works. Add mods (Installing and removing mods).
  • Hooks off for this car: HMG-API still works (mods' files, settings, apps and services), but mods that change the car's own apps wait for your car's hook map. Make a Car Report and send it: that's what's needed to add your car.

A USB stick left in the port can start wired Android Auto and keep wireless from connecting, so take it out after installing.

Clone this wiki locally