Skip to content

Releases

Handtop v0.4.1 — Controls app, and Videos, Music and Image Viewer

Choose a tag to compare

@junsulee119 junsulee119 released this 18 Nov 05:07

Handtop v0.4.1: the new Controls app, profiles that switch per app, the Videos player and the Music app

Controls and media. A Controls app for every button, with profiles that switch by themselves per app, plus apps for videos, music and pictures.

Which image do I need?

  • Most RG35XX H units: handtop-20261118-v0.4.1.img.xz
  • If that image does nothing at power-on (no LED at all), your unit has DDR3 RAM: handtop-20261118-v0.4.1-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-20261118-v0.4.1.img.xz 8290e50d26df41f5039f7c0864bd0472a56d80ddc2ed817ff34f684151a8af01
handtop-20261118-v0.4.1-DDR3.img.xz f040fe7cacc2dcbd2f2cd45c66dd1c99efe934f722feb324ca0e39f3729982b3

What's new in v0.4.1

Controls app (Apps → Controls)

Everything about the controls in one place, applied at once, with no re-login.

  • Buttons: click a button on a picture of the handheld and pick what it does: a click, a key, a key combination, an app, a macro and more.
  • Pointer & more: pointer speed and acceleration, scroll speed with a test page to try it on, natural scrolling, gamepad buttons by position or by label, and vibration strength.
  • Advanced: remap the D-pad, Volume, F and Power too (holding Power to shut down always works); button combinations (hold one button, press another); macros, built step by step or recorded from any app; a live view of both sticks with the dead zone; timing; profiles you can export and import.
  • Profiles switch by themselves per app: link apps to a profile (Advanced → Profiles → Apps…) and it is used while one of them is in front, with a short "Profile: …" note.
  • Can't lock you out: button and pointer changes run 15 s on trial ("Keep these controls?") and undo themselves unless you keep them, even if the app is closed.

The boot partition's rg35xxh-input.conf is now a rescue file, all commented out: if the controls are ever broken, uncomment use_app_settings = no at the top. Cards flashed with v0.4.0 or older keep their old file, which still works but fixes every setting it lists.

Videos, Music and Image Viewer

  • Videos: your videos in ~/Videos (and on a USB stick or SD card) with thumbnails and "Resume at"; hardware-decoded and full screen, with big themed controls. A pauses, the right stick seeks, R1 / R2 go to the next / previous video, L1 closes.
  • Music: your songs in ~/Music, folder by folder with album covers, shuffle and repeat. The handheld doesn't sleep while music plays; after 5 minutes without input the screen turns off and the music goes on, and Vol still works.
  • Image Viewer (Ristretto) replaces imv for pictures: it follows the theme and browses the folder with a thumbnail strip. The File Manager now shows picture thumbnails too.

All three have icons in all nine themes.

Fixes

  • A rare video failure in Chromium and VLC: the VA-API driver takes upstream's fix for a race that could make a video frame's allocation fail.

Disclaimer

Handtop is an unofficial hobby project, not affiliated with Anbernic, ROCKNIX, LibreELEC, Debian, Microsoft or Nintendo. Use at your own risk; see the Disclaimer section in the README.

Full history in CHANGELOG.md.

Handtop v0.4.0 — Themes: Retro, Glass, Pocket, Signal and your own

Choose a tag to compare

@junsulee119 junsulee119 released this 12 Nov 03:56

Handtop v0.4.0: the new theme system, with the four new built-in looks: Retro's app drawer in 90s pixel art, Glass's see-through power menu, Pocket's green game-console app drawer and Signal's black, white and red power menu

Themes. Nine looks built in, your own copies in a few taps, and theme files you can share.

Which image do I need?

  • Most RG35XX H units: handtop-20261112-v0.4.0.img.xz
  • If that image does nothing at power-on (no LED at all), your unit has DDR3 RAM: handtop-20261112-v0.4.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-20261112-v0.4.0.img.xz ab61303d49dff6b77d5131f80630b5d2d8dd3883c67b0286b14265ae59b00d32
handtop-20261112-v0.4.0-DDR3.img.xz 1d83a8bd59dd7480573f21d733e4802053f9a5046555a1be8cb3127dec295afe

What's new in v0.4.0

Themes

A theme now changes the whole desktop: the taskbar and its icons, the app drawer, the power menu, notifications, window title bars, the on-screen keyboard, the terminal, the volume / brightness bar, the pointer, fonts and the wallpaper. Open Apps → Theme, pick one and press Apply.

  • Four new looks:
    • Retro: a 90s desktop with grey bevelled buttons, navy title bars, a teal desktop, pixel-art icons, its own pointer and a DOS-style terminal.
    • Glass: light and modern, with see-through panels over a blue-to-violet gradient and a floating taskbar.
    • Pocket: a pocket game console in four greens, with a dot-matrix home screen, hearts for the battery and apps as game cartridges.
    • Signal: a minimal design object in warm white and black with one signal red.
  • Also built in: Handtop dark and light, as before, plus Debian (a stock Debian desktop), High contrast and Grayscale.
  • Make your own copy: Duplicate any theme and pick its name, accent and background colours, dark or light icons, pointer size and text size, with a live preview.
  • Share themes: Export writes a theme to one .handtop-theme file, and Import installs one from your home folder, a USB drive or an SD card. A file is checked before anything changes; if something is wrong, the app lists exactly what.
  • Design your own from scratch, by hand or with an AI agent. A theme is a theme.json with colours, plus optional images, its own pointer, fonts and a little CSS. Anything left out comes from Handtop dark or light. Every exported theme has a GUIDE.md inside that lists everything a theme can set. How to do it, with a ready-made prompt for agents: docs/themes.md.

A theme's pointer changes at the next log-in; the app offers Log out now.

Fixes

  • Bluetooth on the first boot after flashing: the fix from v0.3.9 is now confirmed on fresh flashes, so the known-issue note is gone.
  • The taskbar's power button sometimes did nothing after the power menu had been opened with the Power key. Fixed.

Disclaimer

Handtop is an unofficial hobby project, not affiliated with Anbernic, ROCKNIX, LibreELEC, Debian, Microsoft or Nintendo. Use at your own risk; see the Disclaimer section in the README.

Full history in CHANGELOG.md.

Handtop v0.3.9: HDMI fixes and device notifications

Choose a tag to compare

@junsulee119 junsulee119 released this 06 Nov 11:11

HDMI fixes, notifications when things are plugged in or connect, and a fix for Bluetooth missing on the first boot.

⚠️ Known issue (fix included, not yet confirmed): Bluetooth was sometimes missing on the first boot after flashing. This release should fix it (below). If it still happens, restart once (Power → Restart) and please attach the newest logs/bt-NNNN.txt from the boot partition to an issue.

Which image do I need?

  • Most RG35XX H units: handtop-20261106-v0.3.9.img.xz
  • If that image does nothing at power-on (no LED at all), your unit has DDR3 RAM: handtop-20261106-v0.3.9-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-20261106-v0.3.9.img.xz a9fa74b0b0fce74b599344c8eae8261d24e94eaf6bbb52a43ed28cb48e01cbde
handtop-20261106-v0.3.9-DDR3.img.xz fa0ed796aefd1eb7684468bcc6af22b2792cef8876a6cbcddb112485ee89a5e9

What's new in v0.3.9

Notifications

  • USB devices: plugging in or pulling out a keyboard, mouse, controller, hub, Wi-Fi, Bluetooth or network adapter, audio device or webcam shows what it is and its name. If no driver takes it, the notification says so. USB drives and SD cards keep their own notifications.
  • Bluetooth devices: a paired controller, mouse or headset now shows when it connects or disconnects. Before, this only happened while Bluetooth Manager was open.
  • Charger and battery: "Charging" or "Charger unplugged" with the battery level, and "Fully charged" once when the battery is full.
  • Monitor: unplugging it tells you the picture is back on the handheld screen.

HDMI

  • No taskbar and a slow pointer on some monitors, fixed. On a 1920×1200 monitor, Monitor only left the screen without a taskbar and with the pointer at handheld speed, and unplugging didn't bring the taskbar back. The monitor's own best mode was more than the handheld's HDMI can drive. Now the Display app only picks modes from the monitor's list, checks after every change that the monitor really came on, and otherwise keeps the handheld screen on and tells you. The taskbar restarts by itself if it ever stops, and the pointer keeps its monitor speed.
  • A notification stuck on the monitor, fixed. After keeping a new resolution, its notification could stay frozen at the top left of the monitor, and later notifications didn't show until a reboot.
  • Every display change is logged to ~/.local/state/session/display.log. If a monitor misbehaves, please attach it to an issue.

Bluetooth

  • Missing on the first boot after flashing, should be fixed. On those boots the Bluetooth chip stayed silent until its driver started it again. A boot check now notices that within a few seconds and restarts the driver once, so Bluetooth is up before the desktop appears. Every boot also leaves a short record in logs/bt-NNNN.txt on the boot partition. It hasn't been seen on a real failing boot yet, so the known-issue note stays for now.

Disclaimer

Handtop is an unofficial hobby project, not affiliated with Anbernic, ROCKNIX, LibreELEC, Microsoft or Nintendo. Use at your own risk; see the Disclaimer section in the README.

Full history in CHANGELOG.md.

Handtop v0.3.8 — Battery saver and low-battery shutdown (+ YouTube on the hardware decoder since v0.3.5)

Choose a tag to compare

@junsulee119 junsulee119 released this 05 Nov 14:19

Handtop v0.3.5 to v0.3.8: the power menu with the Battery saver button, the low-battery shutdown countdown and the green-outlined battery icon, and YouTube playing in Chromium on the video engine

Battery saver, a low-battery warning and shutdown, and exact 10-bit VP9 and HEVC at every video width.

⚠️ Known issue (still open): Bluetooth is sometimes missing on the first boot after flashing (the Bluetooth icon shows it off and External Controller → Bluetooth can't start). Restart once (Power → Restart); it works from then on.

Which image do I need?

  • Most RG35XX H units: handtop-20261105-v0.3.8.img.xz
  • If that image does nothing at power-on (no LED at all), your unit has DDR3 RAM: handtop-20261105-v0.3.8-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-20261105-v0.3.8.img.xz 106b0afab8bd72e8cab3539a771bf99fd70cd2dcc56958fca3b55829615dfa71
handtop-20261105-v0.3.8-DDR3.img.xz a789e9270614ce87a9567caf72392c67873561e4087b1aa088edfdad1a2ef466

What's new in v0.3.8

Battery

  • Battery saver. One switch caps the CPU at 1.0 GHz (from 1.4 GHz) and halves the screen brightness; turning it off puts both back. Switch it with the new Battery saver button in the power menu, which also works over fullscreen apps, or by tapping the battery on the taskbar, which gets a green outline while it's on. It stays on across reboots. How much it saves isn't measured yet; most of it should come from the dimmer screen.
  • Low-battery warning and shutdown. At 10 % a warning stays on screen until you tap it and the handheld buzzes three times. At 5 % it counts down 3 minutes in the notification, then shuts down cleanly; plugging in the charger cancels it. Running the battery flat can damage the SD card's filesystem. Both levels can be changed or turned off in /etc/rg35xxh/power.conf.
  • The power menu is now a 3 + 2 grid: Sleep, Restart, Shut down / Battery saver, Log out.

Video

  • 10-bit VP9 and HEVC are exact at every width. In v0.3.7, 10-bit VP9 at a few unusual widths (for example 352, 416, 1282) was very close to the software result but not identical, and 10-bit HEVC 1282 pixels wide was visibly wrong. The decoder now uses Jernej Skrabec's buffer layout fix from LibreELEC, which replaces two of Handtop's own patches. All 25 test clips (VP9 and HEVC 8/10-bit, H.264, VP8, MPEG-2) now match software decoding bit for bit. Unchanged limit: 10-bit VP9 at 4K doesn't fit in the decoder's memory.

For builders

  • The weekly upstream check now also watches Arm's GNU toolchain releases. ROCKNIX releases built with GCC 16 wait until Arm publishes GCC 16, so Handtop's kernel modules keep using the same compiler as ROCKNIX's kernel (docs/kernel.md).

Thanks

  • @stockmind for reporting the 10-bit issue and testing the fix (#8).

Disclaimer

Handtop is an unofficial hobby project, not affiliated with Anbernic, ROCKNIX, LibreELEC, Microsoft or Nintendo. Use at your own risk; see the Disclaimer section in the README.

Full history in CHANGELOG.md.

Handtop v0.3.7 — VP9 hardware decoding and a sleep warning

Choose a tag to compare

@junsulee119 junsulee119 released this 04 Nov 16:23

VP9 on the video engine, 8- and 10-bit, contributed by @stockmind. The screen now dims as a warning before auto-sleep, and the power menu is fixed.

⚠️ Known issue (still open): Bluetooth is sometimes missing on the first boot after flashing (the Bluetooth icon shows it off and External Controller → Bluetooth can't start). Restart once (Power → Restart); it works from then on.

Which image do I need?

  • Most RG35XX H units: handtop-20261105-v0.3.7.img.xz
  • If that image does nothing at power-on (no LED at all), your unit has DDR3 RAM: handtop-20261105-v0.3.7-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-20261105-v0.3.7.img.xz fe00627d76209e507ecbf2601eeee69ed4ab70d8c059853ccbf7565c83d3ba15
handtop-20261105-v0.3.7-DDR3.img.xz 3c53d149f35c18de6ae8bb21dd23f72ec770a8b30a281e3acddef296e68400ec

What's new in v0.3.7

Video

  • VP9 plays on the video engine, 8- and 10-bit. The handheld's video engine can decode VP9, but the Linux driver had no support for it, so VP9 played on the CPU. The image now carries Jernej Skrabec's VP9 driver patches from LibreELEC. The output is identical to software decoding at the common sizes (720p, 1080p, 4K and more). At 1080p VP9 now takes about 11 % of one CPU core instead of 107 %. This helps local files, mpv, ffmpeg and VLC. YouTube in Chromium stays on H.264 (pick 480p), as in v0.3.6.
  • mpv hands the video straight to the screen (vo=dmabuf-wayland), which takes about half the CPU of before. Formats the video engine can't decode, like AV1, still play through the old path.
  • Limit: 10-bit VP9 at a few unusual widths (for example 352, 416, 1282) is very close to the software result but not identical. 8-bit, and 10-bit at 720p, 1080p and 4K, are exact.

Desktop

  • The screen dims 10 seconds before auto-sleep. Touch anything and it comes back, and the 10 minutes start over. It only happens when the handheld would really go to sleep, so not while charging, in controller modes, with HDMI or in Screen off. You can change the seconds, or turn it off with 0, in /etc/rg35xxh/power.conf (AUTOSLEEP_DIM_SECONDS).
  • Power menu: Sleep no longer stays highlighted while the pointer is on another button, and all four buttons are now the same width.

For builders

  • The weekly upstream check can now watch one folder of a busy repository (git-path), and it tracks the LibreELEC VP9 patches that way. ROCKNIX 20261101 was looked at and skipped: it changes nothing in the RG35XX H's kernel.

Thanks

  • @stockmind for VP9 on the video engine (#6): the patches, a fix of his own on top, the test tools, and the quick turnarounds in review. He also spotted a memory issue at some 10-bit widths, which is fixed before release (#8).

Disclaimer

Handtop is an unofficial hobby project, not affiliated with Anbernic, ROCKNIX, LibreELEC, Microsoft or Nintendo. Use at your own risk; see the Disclaimer section in the README.

Full history in CHANGELOG.md.

Handtop v0.3.6 — Security fixes, YouTube on the video engine, audit clean-up

Choose a tag to compare

@junsulee119 junsulee119 released this 02 Nov 12:08

Security and reliability release: FFmpeg brought up to Debian's 7.1.5, Bluetooth controller modes that only accept what a controller needs, YouTube and Chromium decoding on the video engine, and fixes for every finding of an external review of the whole codebase.

This release carries security fixes. Installed handhelds only get them by reflashing (an update system without reflashing is planned).

⚠️ Known issue (still open): Bluetooth is sometimes missing on the first boot after flashing (the Bluetooth icon shows it off and External Controller → Bluetooth can't start). Restart once (Power → Restart); it works from then on.

Which image do I need?

  • Most RG35XX H units: handtop-20261102-v0.3.6.img.xz
  • If that image does nothing at power-on (no LED at all), your unit has DDR3 RAM: handtop-20261102-v0.3.6-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-20261102-v0.3.6.img.xz d8de59b58f4b173cfd4a66fe4ef5d0477da33bd6aa950dd0e439fb6cbc2b8965
handtop-20261102-v0.3.6-DDR3.img.xz 5ffd2627dfb7eecfffd8555b12577279921d4bfbeead6a04d1d01ced6ae778e3

What's new in v0.3.6

Security

  • FFmpeg 7.1.5. The hardware-decoding FFmpeg was based on 7.1.3 while Debian ships 7.1.5: about 390 upstream commits behind, including fixes for two crafted-media-file bugs (CVE-2026-8461, CVE-2026-38347). Because it replaces Debian's libraries, Debian's updates never reached it. It's now built on 7.1.5 with the same hardware decoding; ffmpeg -version shows 7.1.5-handtop-v4l2request-….
  • Bluetooth controller modes no longer accept everything. While a mode waited for a PC or Switch, any nearby device could pair, and in Bluetooth: Xbox it was trusted for good, so it could have posed as a keyboard. Now each mode accepts only what a controller needs, Bluetooth keyboards and mice pause while a mode is on (yours come back afterwards), only the device that actually uses the handheld as a controller is trusted, and anything else that paired during the mode is removed when it ends. Pairing works as before.

Video

  • YouTube plays on the video engine in Chromium. Chromium installs the enhanced-h264ify extension on first launch, so YouTube sends H.264, which the handheld decodes in hardware. Pick 480p: the screen is 640×480.
  • Chromium and VLC use hardware decoding (VA-API over the V4L2 request API), with no flags. Contributed by @stockmind (#5). Measured at 1080p: Chromium about 160 % of one core instead of 255 %, VLC 11 % instead of 227 %.

Fixes

  • Controls are harder to lose. A typo in rg35xxh-input.conf used to stop the input daemon, leaving no buttons; now that line is ignored and the reason logged. Input errors restart the daemon within seconds, and buttons no longer get stuck held after a busy moment.
  • External Controller: over Bluetooth, a button release could get lost when the radio was busy; it's now sent again. Stopping USB mode while it's still starting always cleans up.
  • Screen off: logging out (or a crash) while the screen was off no longer leaves the next session with the screen dark and one CPU core.
  • Display: with an HDMI monitor at a scale other than 1, Extend puts the handheld's screen right below the monitor (no gap). A resolution Test always switches back after 15 s.
  • Wi-Fi from wifi.txt: if the password is refused (WPA needs 8–63 characters), your existing Wi-Fi profile now stays.

For builders

  • Go 1.27.3 for the launcher; kernel modules build on arm64 hosts too; an edited kernel patch is picked up by the next build.
  • CI on every push and a weekly check for upstream updates of everything Handtop builds itself (docs/upstreams.md). Security reports: see SECURITY.md (private reporting is on).

About the review

Codex reviewed the whole codebase against v0.3.5 and reported 18 findings (2 High, 13 Medium, 3 Low). All were confirmed and all are fixed in this release; every fix that touches the handheld was tested on it. The report, its evidence and what was done about each finding are in docs/audits/.

Thanks

  • @stockmind for the VA-API work (#5) that gets Chromium and VLC onto the video engine, including the fixes to the VA-API driver for this handheld's decoder.

Disclaimer

Handtop is an unofficial hobby project, not affiliated with Anbernic, ROCKNIX, Microsoft or Nintendo. Use at your own risk; see the Disclaimer section in the README.

Full history in CHANGELOG.md.

Handtop v0.3.5: Switch Controller mode

Choose a tag to compare

@junsulee119 junsulee119 released this 29 Oct 12:56

Handtop v0.3.5

Switch Controller mode (USB and Bluetooth), a Battery saver for External Controller, Bluetooth LE mice and keyboards, the newer screen panel detected automatically, and a fix for the vibration freeze.

⚠️ Known issue (still open): Bluetooth is sometimes missing on the first boot after flashing (the Bluetooth icon shows it off and External Controller → Bluetooth can't start). Restart once (Power → Restart); it works from then on.

Which image do I need?

  • Most RG35XX H units: handtop-20261029-v0.3.5.img.xz
  • If that image does nothing at power-on (no LED at all), your unit has DDR3 RAM: handtop-20261029-v0.3.5-DDR3.img.xz

Flash with balenaEtcher or Rufus, boot from the TF1 (left) slot. Login rg / rg35xxh; SSH is off until Apps → Enable SSH.

Newer screen panel (rev6): nothing to copy any more. Handtop reads which screen your unit has at every start and picks the right device tree by itself (it may restart once on the first boot).

File SHA-256
handtop-20261029-v0.3.5.img.xz 1c934d0ad2378b7be0e0b87d2c2a9bfb930af72e9b387c8cbe511813d366cb5e
handtop-20261029-v0.3.5-DDR3.img.xz 153777f5a4c6a5c1ab22d9269a150756defd1af285dfc8d36afaec4406cf96b7

What's new in v0.3.5

Switch Controller mode

  • USB cable: Switch. The handheld becomes a wired Switch controller (it poses as HORI's licensed wired pad, so no setup on the Switch). Right USB-C port → the dock's USB-A port, or a USB-C OTG adapter without the dock. F = Home (hold for quick settings), F + Select = Capture. No vibration (that pad type has none).
  • Bluetooth: Switch (experimental). Pairs as a Pro Controller (Controllers → Change Grip/Order the first time; it reconnects by itself afterwards). Same controls, and vibration works. While it is on, other Bluetooth devices disconnect (the app lists them and asks first).
  • Both tested with Ryujinx on a PC (Mario Kart 8 DX, Smash), not on a real Switch yet: please report how it goes! In Ryujinx pick Pro Controller and rebind A/B/X/Y once.
  • The External Controller app keeps its two cards, each split into Xbox and Switch.

External Controller

  • Battery saver (switch in the app, off by default): the screen turns off 30 s after the other device connects and the status screen draws much less. Vol+/- or Power shows it for 10 s. About half the CPU use in Bluetooth modes (70 % → 33 % in Xbox mode), plus no display or backlight.
  • Xbox: better compatibility (Bluetooth card): for PC Bluetooth adapters that won't pair with the Xbox mode, especially cheap clone dongles. The handheld then pairs as an Xbox One S controller over classic Bluetooth (pair again on the PC). Tested with an iPhone so far; Windows reports welcome.
  • Clearer names on the other device: "Handtop (Xbox)" / "Handtop (Switch)" (Bluetooth Switch mode has to be "Pro Controller"). An existing Windows pairing keeps the old name until you pair again; it works either way.

Fixes

  • The handheld could freeze with the motor buzzing when a game's vibration kept changing strength. The cause was a locking bug in ROCKNIX's gamepad driver; Handtop now ships a fixed build. Every kernel-level difference from ROCKNIX is listed in docs/kernel.md.
  • Bluetooth LE mice and keyboards work (they paired but did nothing: ROCKNIX's kernel lacks the uhid driver BlueZ needs; Handtop adds it).
  • Newer screen panel (rev6) detected automatically, and its device tree now has hardware video decoding too. If it ever picks wrong, write rev6 or regular in panel.txt on the boot partition.

Known limitations

  • Switch modes not yet tested on a real Switch.
  • Better compatibility mode not yet tested on Windows.
  • Bluetooth sometimes missing on the first boot (see the note at the top).

Disclaimer

Handtop is an unofficial hobby project, not affiliated with Anbernic, ROCKNIX, Microsoft or Nintendo. Use at your own risk; see the Disclaimer section in the README.

Thanks

  • u/Boldiatti for the Bluetooth dongle reports and tests that led to Better compatibility mode.
  • Everyone on Reddit who reported the rev6 screen and USB hub behaviour.

Full history in CHANGELOG.md.

Handtop v0.3.0 — New look, hardware video, Xbox over Bluetooth

Choose a tag to compare

@junsulee119 junsulee119 released this 27 Oct 10:39

Handtop v0.3.0

A new look for Handtop, a real-keyboard on-screen keyboard, hardware video decoding, an Xbox controller over Bluetooth, and a lot of work under the hood to make it safer.

⚠️ Known issue: Bluetooth is sometimes missing on the first boot after flashing (the Bluetooth icon shows it off and External Controller → Bluetooth can't start). Restart once (Power → Restart); it works from then on. We're still looking into the cause.

Which image do I need?

  • Most RG35XX H units: handtop-20261027-v0.3.0.img.xz
  • If that image does nothing at power-on (no LED at all), your unit has DDR3 RAM: handtop-20261027-v0.3.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.

Screen shows garbled lines or stays black, but the image boots? Your unit has the newer screen panel. Put the card in your PC, open the RG35XXHBOOT drive and copy device_trees\sun50i-h700-anbernic-rg35xx-h-rev6-panel.dtb over dtb.img (replace it). Then boot again. This is not a DDR3 problem: keep the regular image.

File SHA-256
handtop-20261027-v0.3.0.img.xz db682e6960699e09cd3be7a6b80b91154ba4117587a12e590b9af78736f432d9
handtop-20261027-v0.3.0-DDR3.img.xz 5e683f4ce21afbd2098b4a86ebd5400aff2cee5481c03ffa800ce1b0b33d1f04

What's new in v0.3.0

A new look

  • The Handtop logo, and wallpapers with the logo carved in (dark and light).
  • An animated boot screen: the logo's keyboard types while the real boot log scrolls beside it.
  • Pixel-art mouse cursor, power menu (Sleep, Restart, Log out, Shut down) and taskbar (Apps button, red power button, even spacing).
  • The default apps have plain names and pixel-art icons: Terminal, File Manager, Text Editor, Web Browser, System Monitor, Code Editor, PDF Viewer, Archive Manager.
  • Pixel-art Wi-Fi and Bluetooth tray icons; softer terminal colours; a new volume / brightness bar.

On-screen keyboard, redesigned (X)

  • Laid out like a real keyboard: staggered rows, Enter and Backspace where you expect them, ↑ above ↓.
  • Every typed key shows a press, hold A to repeat, L2 = Shift while it's open, and small badges show which shoulder button types which key.
  • Light theme, and it now stays on top of the Apps screen.

Hardware video decoding, contributed by @stockmind in #3, thank you!

  • H.264, HEVC, MPEG-2 and VP8 decode on the handheld's video engine in mpv and FFmpeg, zero-copy. Details: docs/video-decode.md.

External Controller

  • Bluetooth mode is now an Xbox controller (Xbox Wireless Controller over Bluetooth LE): Windows uses its own Xbox driver, XInput-only games work, and game vibration now works over Bluetooth too. If you used it with v0.2.0, remove "Handtop Gamepad" on the PC and pair it again once.
  • No more stick lag over Bluetooth on Windows.

External display (Apps → Display)

  • The Display app opens by itself when you plug in a monitor: Monitor only / Extend / Mirror, plus resolution and refresh rate with a 15 s "Keep this mode?" test. Remembered per monitor.
  • Extend puts the handheld below the monitor; the pointer moves faster on the bigger screen.

SD cards and USB sticks

  • The TF2 card and USB sticks show up in Files and mount with a tap, with "inserted" / "removed" notifications.

Safer under the hood

  • Logging out now cleans up the previous session properly (v0.2.0 left a second input daemon and Tailscale icon running), and the controls hand over safely between sessions.
  • If the controls ever stop responding, they restart by themselves within about 10 s ("Controls restarted").
  • A review of everything that touches the hardware fixed several edge cases: vibration on Re-center sticks, a failed USB-cable start, and a 90 s hang when switching from Bluetooth to USB cable. New rules for contributors in docs/hardware-safety.md and AGENTS.md.
  • The Bluetooth taskbar icon no longer needs blueman's tray applet (~55 MB less memory).

Known limitations

  • Bluetooth controller mode is tested with Windows 11 only so far; reports from Android, macOS or Linux are welcome!
  • Bluetooth sometimes missing on the first boot (see the note at the top).

Contributors

  • @stockmind: hardware video decoding in FFmpeg and mpv on the Cedrus VPU (#3)

Full history in CHANGELOG.md.

Handtop v0.2.0

Choose a tag to compare

@junsulee119 junsulee119 released this 21 Oct 11:27

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.

Handtop v0.1.3

Choose a tag to compare

@junsulee119 junsulee119 released this 17 Oct 08:16

Which image do I need?

  • Most RG35XX H units: handtop-20261017-v0.1.3.img.xz
  • If that image does nothing at power-on (no LED at all), your unit has DDR3 RAM: handtop-20261017-v0.1.3-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-20261017-v0.1.3.img.xz cb4be09df54fd74e93592b2010042aa2d89742a365f603984626adf92da3fe1d
handtop-20261017-v0.1.3-DDR3.img.xz af6984246b19d961df2642df70de6a4650c4bdf55ebd9453d1426f4f16a4cd3a

What's new in v0.1.3

  • Chromium replaces Firefox. In side-by-side tests on the device, Chromium with uBlock Origin Lite scrolled much smoother (4/3 vs 2/1 on Wikipedia/Naver) using less than half the CPU and leaving ~200 MB more free RAM. uBlock Origin Lite installs automatically the first time Chromium starts with internet. Full results in docs/desktop.md.
  • /tmp is now 256 MB (it could fill up during heavy browsing).

Also included (from v0.1.2)

  • DDR3 boards supported with their own image (#1, thanks @Aaronhrndz). Charging while switched off is not confirmed on DDR3 yet.
  • On-screen keyboard follows your click button if you remap it (#2, thanks @Aaronhrndz).

Full history in CHANGELOG.md.