/raspberrify

A minimal Spotify interface for the Raspberry Pi SenseHat.

Primary LanguagePythonMIT LicenseMIT

raspberrify

A minimal Spotify interface for the Raspberry Pi SenseHat.

Description

The Raspberry Pi SenseHat has an 8x8 LED matrix as well as a small joystick. Using the Spotify Web API, it's possible to fetch album art to display on the SenseHat matrix, as well as control playback using the joystick. These are the features targeted for an 1.0.0 release.

Getting started

Prerequisites

  • A Raspberry Pi with Raspbian OS and a Sense Hat
  • libjpeg, run sudo apt install libjpeg-dev zlib1g-dev if Pillow fails during installation due to missing jpeg.
  • RTIMULib: Since the version of RTIMULib available through pip doesn't install on a current version of Raspbian OS, you need to run git clone https://github.com/RPi-Distro/RTIMULib to grab a working version. Do this in the parent directory of raspberrify to get it to work with the install script.

Installation

This project is using Poetry for dependence management. After installing Poetry, run poetry install in the root directory to download all dependencies.

Configuration

Secrets needed for Spotify authorization are specified in .env files. The provided .env.example shows the requred fields. Create a .env.secrets file to specify your credentials, which can be obtained through the Spotify Developer Dashboard.

Running the script

Run poetry run python3 raspberrify/main.py in the cloned base directory.

Version history

This project is not finished yet - i mainly still want to add support for controlling playback through the SenseHat joystick.

License

This project is licensed under the MIT License - see the LICENSE.md file for details

Acknowledgements