Skip to content

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
· 22 commits to main since this release

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.