Skip to content


Switch branches/tags

Name already in use

A tag already exists with the provided branch name. Many Git commands accept both tag and branch names, so creating this branch may cause unexpected behavior. Are you sure you want to create this branch?

Latest commit


Git stats


Failed to load latest commit information.
Latest commit message
Commit time

Unicorn HAT HD

Build Status Coverage Status PyPi Package Python Versions


Full install (recommended):

We've created an easy installation script that will install all pre-requisites and get your Unicorn HAT HD 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/unicornhathd/. To prototype and try out your code without having to deploy it onto a Raspberry Pi every time, you can use the Unicorn HAT simulator to run a mock Unicorn HAT on your computer.

Manual install:

SPI needs to be enabled to communicate with the Unicorn Hat HD. If the SPI on your Pi is not enabled or you are unsure if it is:

sudo raspi-config nonint do_spi 0
sudo reboot

Library install for Python 3:

sudo apt-get install python3-pip python3-dev python3-spidev
sudo pip3 install unicornhathd

Library install for Python 2:

sudo apt-get install python-pip python-dev python-spidev
sudo pip install unicornhathd


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 apt-get install python-dev python-setuptools
sudo python3 install

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

In all cases you will have to enable the SPI bus.

Documentation & Support