CircuitPython Installation

First make sure you are running the latest version of Adafruit CircuitPython for your board, and that sharpdisplay is in its supported modules list.

This feature is very new and not currently available in the latest public build, so you will need to go to, select your board, and find the "Absolute Newest" image.


Next you'll need to install the necessary libraries to use the hardware--carefully follow the steps to find and install these libraries from Adafruit's CircuitPython library bundle.  Our CircuitPython starter guide has a great page on how to install the library bundle.

There are many libraries in the bundle that enhance displayio, but the two we need for the example code are

  • adafruit_display_text - to show text and labels
  • adafruit_bitmap_font - to load fonts from CIRCUITPY for better typography than the "built in" font

Before continuing make sure your board's lib folder or root filesystem has the adafruit_display_text and adafruit_bitmap_font folders copied over.

This guide was first published on Jun 22, 2013. It was last updated on Apr 16, 2024.

This page (CircuitPython displayio Setup) was last updated on Mar 08, 2024.

Text editor powered by tinymce.