Documentation Status Discord Build Status Code Style: Black

A helper library for displaying lines of text on a display using displayio.


This driver depends on:

Please ensure all dependencies are available on the CircuitPython filesystem. This is easily achieved by downloading the Adafruit library and driver bundle or individual libraries can be installed using circup.

This library works with any microcontroller with a built in display, or a microcontroller with an external display connected.

Purchase one from the Adafruit shop.

Usage Example

This example takes the microcontroller CPU temperature in C and F, and displays it on the display under the heading “Temperature Data!”.

import microcontroller
from adafruit_simple_text_display import SimpleTextDisplay

temperature_data = SimpleTextDisplay(title="Temperature Data!", title_scale=2)

while True:
    temperature_data[0].text = "Temperature: {:.2f} degrees C".format(
    temperature_data[1].text = "Temperature: {:.2f} degrees F".format(
        (microcontroller.cpu.temperature * (9 / 5) + 32)


API documentation for this library can be found on Read the Docs.

For information on building library documentation, please check out this guide.


Contributions are welcome! Please read our Code of Conduct before contributing to help this project stay welcoming.

Table of Contents


Indices and tables