Skip to content

Installation

Precompiled .mpy packages from the PyDevices micropython-lib fork:

https://PyDevices.github.io/micropython-lib/mip/PyDevices

import mip
mip.install("pdwidgets", index="https://PyDevices.github.io/micropython-lib/mip/PyDevices")

pdwidgets declares MIP dependencies on eventsys, graphics, multimer, and palettes — mip installs them from the same index when needed.

CPython — TestPyPI

Wheels are published to TestPyPI for development and CI (not production PyPI). Use the two-index pattern:

pip install \
  -i https://test.pypi.org/simple/ \
  --extra-index-url https://pypi.org/simple/ \
  pdwidgets displaysys pydisplay-graphics eventsys multimer pydevices-palettes

You also need a pydisplay board_config for your display backend. See pydisplay desktop quick start.

PyScript (browser)

Widget gallery examples in pydisplay PyScript install pdwidgets at runtime via the micropython-lib MIP index (# pyscript mip: pdwidgets in example headers).

On the Pyodide (CPython) loader, examples may use # pyodide wheels: pdwidgets to micropip-install from TestPyPI.

Full source clone

git clone https://github.com/PyDevices/pdwidgets.git

Add src/ to sys.path alongside a pydisplay checkout or installed wheels.

Not in pydisplay-bundle

pdwidgets is a separate package and is not included in the pydisplay-bundle MIP metapackage. Install it explicitly when you need widgets.