A fast, pure-Python UI & Widget Toolkit for microcontrollers, embedded touch displays, desktop Python, and the web. Over 50 rich components with zero native C dependencies.
Build composable UI trees with Display, Screen, and nested container widgets that handle layout and clipping automatically.
Efficient frame updates only repaint what changed using pygraphics.Area bounding boxes, maximizing frame rates on embedded SPI panels.
Unified input handling across touch screens, mouse pointers, rotary encoders, joysticks, and physical keyboards with focus navigation.
=== "MicroPython (MIP)"
```python
import mip
# Install pdwidgets and its PyDevices companion packages
mip.install("pydevices", index="https://PyDevices.github.io/mip")
mip.install("pygraphics", index="https://PyDevices.github.io/mip")
mip.install("palettes", index="https://PyDevices.github.io/mip")
mip.install("pdwidgets", index="https://PyDevices.github.io/mip")
```
=== "CPython (TestPyPI)"
```bash
pip install -i https://test.pypi.org/simple/ \
--extra-index-url https://pypi.org/simple/ pydevices-pdwidgets
```
=== "PyScript / Browser"
The wheel is named `pydevices-pdwidgets`; the module you import is
`pdwidgets`. micropip resolves the rest (`pydevices`,
`pydevices-pygraphics`, `pydevices-palettes`) from the wheel metadata.
```python
import micropip
await micropip.install(
"pydevices-pdwidgets", index_urls="https://test.pypi.org/simple/"
)
import pdwidgets as pd
```
On MicroPython the MIP package names are unprefixed
(`mip.install("pdwidgets", index="https://PyDevices.github.io/mip")`).
Click the interactive button and slider below to interact with pdwidgets live in your browser:
display_drv = AutoDisplay(width=320, height=240, canvas_id=CANVAS_ID) app = appdev.App(display_drv) display = pd.Display(display_drv, app) screen = pd.Screen(display, bg=0x18C3)
title = pd.Label(screen, value="pdwidgets Live Demo", x=16, y=16, bg=screen.bg) status = pd.Label(screen, value="Status: Waiting for tap...", x=16, y=45, bg=screen.bg)
count = 0 btn = pd.Button(screen, label="Tap Me", x=16, y=80, w=130, h=38, radius=6, style="raised")
def on_tap(sender, event): global count count += 1 status.value = f"Status: Tapped {count} time{'s' if count != 1 else ''}!"
btn.add_event_cb(pd.events.MOUSEBUTTONUP, on_tap)
slider = pd.Slider(screen, value=0.5, x=16, y=140, w=200, h=24)
print("pdwidgets event loop running! Click 'Tap Me' on canvas.") </textarea>
Every pdwidgets application follows a standard three-stage pattern:
import board_config
import appdev
import pdwidgets as pd
# 1. Initialize Display and Application Controller
app = appdev.App(board_config)
display = pd.Display(board_config.display_drv, app)
screen = pd.Screen(display, bg=0x0000)
# 2. Build UI Hierarchy
label = pd.Label(screen, value="System Ready", x=10, y=10)
button = pd.Button(screen, label="Start", x=10, y=40, radius=4)
def on_click(sender, event):
label.value = "Running!"
button.add_event_cb(pd.events.MOUSEBUTTONUP, on_click)
# 3. That's it -- the app keeps itself alive and handles input from here.Explore full-featured GUI applications built with pdwidgets:
Tactile raised 3D buttons with full arithmetic engine and real-time display readout.
Multi-tab front-desk kiosk with appointment queue, form validation, and confirm dialogs.
Real-time sparkline telemetry charts, analog gauges, and status monitoring dashboard.
PIN entry keypad terminal for secure pickup with numeric buttons and card transitions.
- Architecture & Lifecycle — Display hierarchy, dirty rectangle redraws, and event loop integration.
- Widget Catalog — Complete guide and live demos for all 50+ UI components.
- Layout & Sizing —
ALIGNanchors, percentage sizing (pct), and responsive grids. - Input & Events — Touch gestures, mouse clicks, rotary encoders, and keyboard focus rings.
- Theming & Icons — Palette styling, Material Design colors, corner radii, and icon modules.
- App Recipes — Complete blueprints for Calculators, Smartwatches, and Dashboards.
- API Reference — Autogenerated class and method reference.