PyScript

August 14, 2026 · View on GitHub

Experimental browser support via PyScript and displaydev.psdisplay.PSDisplay.

Quick start: PyScript guide and Try pydevices-examples.

Installable / offline (major feature): The live gallery is a Progressive Web App. Read where PWAs run for the host matrix (desktop Chromium, Android Chrome, iOS home screen, TV web). Build your own with the PyScript PWA guide.

Asyncio porting: PyScript asyncio guide.

!!! warning "Work in progress" PyScript support is experimental. The browser gallery ships curated async and all examples (Run-gated). Other scripts may still use blocking while True loops and need asyncio porting — see PyScript asyncio guide.

Board config

pydevices/board_configs/psdisplay/board_config.py — 320×480 canvas with neutral PSDevices host input. Non-LVGL examples attach it through app_runtime; LVGL uses display_driver.

Apple mobile (iOS / iPadOS)

There is no native iOS app on the foreseeable roadmap. Use Mobile Safari (or another WebKit browser) with the PyScript gallery, optionally Add to Home Screen as a PWA.

Smart TVs (webOS / Tizen)

Browser / PyScript only — see PWA — Smart TVs and the tv_remote_menu example. Do not expect SDLDisplay on those OS shells.

Contributing

Pull requests for displaydev/psdisplay.py belong in pydevices; asyncio example ports and files under .site/pyscript/ belong here.