# ⚙️ HHL Gamepad Config

**HHL Gamepad Config** is the app for configuring and updating Hand Held Legend controllers that run HOJA firmware: GC Ultimate, ProGCC, Super Gamepad+ and others. It runs in the browser, nothing to install:

[**hoja.handheldlegend.com**](https://hoja.handheldlegend.com)

It replaces the older Hoja 2 config tool.

## What you need

* **A Chromium browser:** Chrome, Edge, Opera or Brave on Windows, macOS, Linux, ChromeOS or Android.
* **A USB data cable.** Many cables only charge. If the controller lights up but never shows in the browser's list, try another cable, plugged straight into the computer.
* Safari, Firefox and every browser on iPhone and iPad can't connect to USB controllers. You can still open the app there and **Try the demo**.

## Connect your controller


1. Plug the controller in while holding **A** or **B**. Only Switch and Steam modes connect to the app (see [Modes & Pairing](https://docs.handheldlegend.com/doc/modes-pairing-hoja-controllers-H61Dy3zPjm)).
2. Open [hoja.handheldlegend.com](https://hoja.handheldlegend.com) and press **Connect controller**.
3. Pick the controller in the browser's list.

 ![Home before connecting: Connect controller, and tips if it doesn't work](https://docs.handheldlegend.com/api/files.get?sig=eyJhbGciOiJIUzI1NiIsInR5cCI6IkpXVCJ9.eyJrZXkiOiJ1cGxvYWRzLzU5ZGZiY2Y1LTNjZGEtNGY4OC1hMDAyLWViYzFkNmQ5NjMyOS8xNzQ2YTE1Mi0wMDQzLTRlYzktOGQ2OS05MjdmNGVlOGJhNDAvaG9qYS1hcHAtY29ubmVjdC5wbmciLCJ0eXBlIjoiYXR0YWNobWVudCIsImlhdCI6MTc5MzgxNzAwMCwiZXhwIjoxNzkzOTAzNDAwfQ.iOXwnYC5EAMiu7bWpsxlkyYsGgNfeAH_ofIwsN66kWo " =480x604")

Once connected, Home shows the controller, its firmware, and anything that needs attention, such as **Joysticks need calibration** or an available update.

 ![Home with a controller connected](https://docs.handheldlegend.com/api/files.get?sig=eyJhbGciOiJIUzI1NiIsInR5cCI6IkpXVCJ9.eyJrZXkiOiJ1cGxvYWRzLzU5ZGZiY2Y1LTNjZGEtNGY4OC1hMDAyLWViYzFkNmQ5NjMyOS9kZGE3NDg4MC1jNjNmLTQ0OTctYTk0NC1mYjc2ODZjOWY1NzcvaG9qYS1hcHAtaG9tZS5wbmciLCJ0eXBlIjoiYXR0YWNobWVudCIsImlhdCI6MTc5MzgxNzAwMCwiZXhwIjoxNzkzOTAzNDAwfQ.GQQN6oplHV0HxcmUEw78MOZouoWAOJRHA6nGkogKBs4 " =560x583")

## Save your changes

Every change applies to the controller **right away**, so you can feel it. It stays only until the controller is unplugged, unless you press **Save** in the top bar. The Save button glows while there are unsaved changes, and the app warns you before you disconnect.

## Back up your settings

On the **Firmware & backup** page, **Backup & restore** saves the controller's settings to a file (**Back up settings**) and loads them back later (**Restore from file**). It's a good idea before a firmware update. Backups can include calibration, which you can choose to restore or not.

The app also makes **automatic backups**: each time a controller connects, it saves one in the browser and keeps the last 5 for each controller. Click **Automatic backups** under Backup & restore to open the list and restore one.

 ![Backup & restore on the Firmware page](https://docs.handheldlegend.com/api/files.get?sig=eyJhbGciOiJIUzI1NiIsInR5cCI6IkpXVCJ9.eyJrZXkiOiJ1cGxvYWRzLzU5ZGZiY2Y1LTNjZGEtNGY4OC1hMDAyLWViYzFkNmQ5NjMyOS8wMDAxMWNmNi1jNDdhLTRiNDAtOGI2NS1hNTU0ZjE0N2Y2MzcvaG9qYS1zZXQtYmFja3VwLnBuZyIsInR5cGUiOiJhdHRhY2htZW50IiwiaWF0IjoxNzkzODE3MDAwLCJleHAiOjE3OTM5MDM0MDB9.5TVJCClB7rWHy_J39zV1UWNxbopewIm1slwBhM7F7fc " =560x96")

## If it won't connect

* **Not in the browser's list:** unplug it, hold **A** or **B**, and plug it back in. Try a different cable or USB port.
* **"The controller is busy in another tab or app":** close other tabs with the app, and other controller tools, then try again.
* **It shows up as "*controller name* Update" (for example GCU 1 Update), RP2 Boot, RPI-RP2 or RP2350:** the controller is in update mode, not running its firmware. See [Update Firmware](https://docs.handheldlegend.com/doc/update-firmware-hoja-controllers-KoFvPA77o1).
* **Linux:** the app's **Help & about** page has a one-time **Linux setup** (a USB rule) that allows the browser to reach the controller.
* **iPhone or iPad:** Apple doesn't allow USB access from the browser. Use a computer or an Android device.

## More

* [Settings Guide](https://docs.handheldlegend.com/doc/settings-guide-hhl-gamepad-config-l1CotarbxU): what each page of the app does.
* [Update Firmware](https://docs.handheldlegend.com/doc/update-firmware-hoja-controllers-KoFvPA77o1) and [Update the Wireless Module](https://docs.handheldlegend.com/doc/update-the-wireless-module-esp32-vhX2Im50kN).
* [Modes & Pairing](https://docs.handheldlegend.com/doc/modes-pairing-hoja-controllers-H61Dy3zPjm).
* **What's new:** the app's What's new page lists every firmware change, newest first.