Repository navigation
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.
- Unzip
hmgapi-<version>-usb.ziponto an empty USB stick (FAT32), at the top level. - Plug the stick into the car's USB port.
- 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.
- Take the stick out once the head unit has restarted.
What happened is written to HMGAPI/install.log on the stick.
- Unzip
hmgapi-<version>-nemesis.ziponto the top level of a USB stick (FAT32 or exFAT), the same way as NEMESIS's own packages: the stick getsNEMESIS.data,packages/hmgapi.zipand a README. Only one NEMESIS package on the stick at a time. - Plug it in once Android is up, and confirm the install of "HMG-API".
- Restart the head unit when it says so, and take the stick out.
Updating through NEMESIS later keeps your mods.
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.
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.
This wiki is published from the wiki/ folder of the main repository: to change a page, edit it there (a pull request is welcome). Edits made here are replaced at the next update.