Python library for Unicorn pHAT and HAT. 32 or 64 blinding ws2812 pixels for your Raspberry Pi
C Python Makefile Perl Ruby Shell Other
Latest commit 23568ba Feb 6, 2017 @Gadgetoid Gadgetoid committed on GitHub Merge pull request #90 from motzke/master
fix clock for 24hours clock

Unicorn HAT/pHAT

Available from Pimoroni:

unicornhat Python Library & Examples

Here you'll find everything you need to start lighting up your Unicorn HAT or pHAT using python.

Python users should probably ignore most of this repository and just:

Full install ( recommended ):

\curl -sS | bash

Install for Python 3:

sudo apt-get install python3-pip python3-dev
sudo pip3 install unicornhat

Install for Python 2:

sudo apt-get install python-pip python-dev
sudo pip install unicornhat

Install from Github clone

git clone
cd unicorn-hat/
sudo apt-get install python-dev python-setuptools
cd library/rpi-ws281x
sudo python install
cd ../..
cd library/UnicornHat
sudo python install
cd ../..

Then proceed to examples.

Using with idle/idle3:

unicornhat needs root access to function. Please make sure you start LXTerminal and run idle or idle3 with the "sudo" command like so:

sudo idle

Documentation & Support

Based Upon rpi_ws281x

unicornhat is based upon a modified, Pi 2/3 compatible version of the RPi ws281x Library by Jeremy Garff.

The library was modified by Richard Hirst.


Note: unicornhat is no longer based upon this library, but this information is included for posterity.

unicornhat was previously based upon a modified version of the ws2812 C driver from: