Skip to content
Python library for the Pimoroni GFX HAT
Branch: master
Clone or download


Build Status Coverage Status PyPi Package Python Versions

Combining a 128x64 pixel monochrome LCD, 6 touch buttons, a 6 zone RGB backlight and 6 button LEDs the GFX HAT has everything you need to turn your Pi into a controller and status display.


Full install (recommended):

We've created an easy installation script that will install all pre-requisites and get your GFX HAT up and running with minimal efforts. To run it, fire up Terminal which you'll find in Menu -> Accessories -> Terminal on your Raspberry Pi desktop, as illustrated below:

Finding the terminal

In the new terminal window type the command exactly as it appears below (check for typos) and follow the on-screen instructions:

curl | bash

If you choose to download examples you'll find them in /home/pi/Pimoroni/gfxhat/.

Manual install:

Library install for Python 3:

sudo pip3 install gfxhat

Library install for Python 2:

sudo pip2 install gfxhat


If you want to contribute, or like living on the edge of your seat by having the latest code, you should clone this repository, cd to the library directory, and run:

sudo python3 install

(or sudo python install whichever your primary Python environment may be)

In all cases you will have to enable the i2c and spi buses.


Files under library/gfxhat/fonts are licensed according supplied OFL licenses.

Bitbuntu and Bitocra fonts from:

Documentation & Support

You can’t perform that action at this time.