Skip to content
Go to file


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

Piano HAT

Piano HAT is a tiny Pi piano with 16 touch-sensitive buttons. It features:

  • 16 Capacitive Touch Buttons
  • 13 Notes from C to C
  • Octave Up/Down
  • Instrument Select


Full install (recommended):

We've created an easy installation script that will install all pre-requisites and get your Piano 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

Alternatively, on Raspbian, you can download the pimoroni-dashboard and install your product by browsing to the relevant entry:

sudo apt-get install pimoroni

(you will find the Dashboard under 'Accessories' too, in the Pi menu - or just run pimoroni-dashboard at the command line)

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

Manual install:

Library install for Python 3:

on Raspbian:

sudo apt-get install python3-pianohat

other environments:

sudo pip3 install pianohat

Library install for Python 2:

on Raspbian:

sudo apt-get install python-pianohat

other environments:

sudo pip2 install pianohat


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 bus.

Documentation & Support

You can’t perform that action at this time.