Enable SPI:

sudo raspi-config nonint do_spi 0

Install the library:

python3 -m pip install keybow

You may need to use sudo (or optionally python in lieu of python3)

• git clone https://github.com/pimoroni/keybow-python
• cd keybow-python
• sudo ./install.sh

Decorator to attach a handler to a Keybow key. Your handler should accept an index and a state argument.

Handler callback params:

• index: Integer - 0-based index of key to set the LED for, see #index
• state: Boolean - True on key down, False on release

@keybow.on()
def handle_key(index, state):
    print("{}: Key {} has been {}".format(
        time.time(),
        index,
        'pressed' if state else 'released'))

Parameters:

• r, g, b: Integer - amount of Red, Green and Blue (0-255)

keybow.set_all(0, 64, 128)
keybow.show()

NOTE: Use keybow.show() to update the LEDs actual state

Parameters:

• index: Integer - 0-based index of key to set the LED for, see #index
• r, g, b: Integer - amount of Red, Green and Blue (0-255)

for x in range(4):
    keybow.set_led(x, 255, 0, 0)
for x in range(4):
    keybow.set_led(x + 4, 0, 255, 0)
for x in range(4):
    keybow.set_led(x + 8,  0, 0, 255)
keybow.show()

NOTE: Use keybow.show() to update the LEDs actual state

Turn off all LEDs

keybow.clear()
keybow.show()

NOTE: Use keybow.show() to update the LEDs actual state

Whenever setting LEDs use this to update the LED values. This needs to be used whenever you set any LED values

With GPIO on the left, the index is mapped out as following: