Repository navigation
Handtop v0.2.0
Your handheld can now be a game controller for your PC or phone, over Bluetooth or a USB cable. Thanks to boldiatti on Reddit for the idea!
Which image do I need?
- Most RG35XX H units:
handtop-20261021-v0.2.0.img.xz - If that image does nothing at power-on (no LED at all), your unit has DDR3 RAM:
handtop-20261021-v0.2.0-DDR3.img.xz
Flash with balenaEtcher or Rufus, boot from the TF1 (left) slot. Login rg / rg35xxh; SSH is off until Apps → Enable SSH.
| File | SHA-256 |
|---|---|
| handtop-20261021-v0.2.0.img.xz | bb00f577d9cfab36960268498cfc0b7fbe8a96732e2fe0c4870c4a5e53dd9f54 |
| handtop-20261021-v0.2.0-DDR3.img.xz | d9bbd682310905fb6693cd8d5ea89c453fd4baed80373314f51c8a90f54eb00f |
What's new in v0.2.0
External Controller (Apps → External Controller): pick Bluetooth or USB cable.
- Bluetooth: the handheld shows up as "Handtop Gamepad". Pair it once; after that it reconnects by itself. Tested with Windows 11. Your other Bluetooth accessories on the handheld pause while it is on.
- USB cable: the handheld becomes a wired Xbox 360 controller. Windows needs no driver, XInput-only games work directly, the PC reads the controls about 1000 times a second, and game vibration plays on the handheld's motor. It charges at the same time. Use the right USB-C port (OTG2/DC).
- One connection at a time. Select + Start + L1 + R1 ends it (the same combo Moonlight uses to quit).
- A full-screen status page shows the connection, a live drawing of the handheld's buttons and sticks, and the battery.
Light theme (Apps → Theme): dark (default) or light, switched live. Covers the taskbar, wallpaper, app drawer, power menu, notifications, window title bars and apps. The terminal, volume bars and on-screen keyboard stay dark for now.
New pixel-art icons
- Taskbar input-mode icon (mouse, handheld, Bluetooth, cable). When the mode changes it gives a little spring shake, and the handheld vibrates in step with it (
haptic_strengthin the input config; 0 turns it off). - Battery icon with 5 bars, red when low, and a charging animation.
- App icons for External Controller and Theme.
Fixes
- Notifications now appear above the power menu and full-screen apps, with Handtop's own style (it was never applied before).
- The mouse pointer hides in gamepad and controller modes.
- The 4th column of the app drawer no longer runs off the screen.
- Vibration requests from a PC or game can no longer freeze the system ("infinite" vibration on some controller testers could lock the handheld up).
Known limitations
- No vibration over Bluetooth yet (USB cable only).
- Bluetooth mode is tested with Windows 11 only so far; reports from Android, macOS or Linux are welcome!
Full history in CHANGELOG.md, details in docs/bt-controller.md.