Display Graphics #

Last updated March 17, 2026
circuitpythongraphics

Everything graphics in CircuitPython is built around the displayio library.

display graphics

First you need a display object, which is usually preconfigured for your board if it has a built in display, as board.display. It will automatically refresh the screen. The root of the screengraph should already be set to a group, so you can append to it.

display = board.display
display.root_group.append(some_gfx_object)