MicroPython-Touch

August 12, 2026 · View on GitHub

micropython-touch by Peter Hinch — touch widgets and async UI (developed from micro-gui).

Requirements

ComponentLocationNotes
board_config.pypydevices/board_configs/display + neutral touch capability
touch_setup.pylib/utils/Fetches touch GUI; mouse/touch PollerDisplay(ssd, tpad)
fetch_ph_gui.pylib/utils/mip install into utils/gui/ + FrameBuffer patches
displaybuf.pylib/utils/ssd framebuffer
uctypes.pylib/utils/CircuitPython shim for writer.py

Upstream renamed hardware_setup.pytouch_setup.py (Dec 2024). pydevices-examples follows that name. Do not install upstream drivers/ or touch/ packages for the bridge — input comes from the selected board config and, for non-LVGL apps, the application-owned eventsys runtime.

Config

import touch_setup  # fetch + Display
from gui.core.tgui import Screen, ssd

Install

import mip
mip.install("github:PyDevices/pydevices-examples/packages/micropython-touch.json", target="./utils")

Or rely on import touch_setup.

Example

lib/examples/touch_gui_simpletest.py — framebuffer smoke test. Full demos: import touch_setup then import gui.demos.simple.

Browser: fetch_ph_gui via touch_setupgallery loader.

See also