Skip to content

Handtop v0.2.0

Choose a tag to compare

@junsulee119 junsulee119 released this 21 Oct 11:27
· 154 commits to main since this release

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_strength in 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.