This guide will walk you through setting up the development environment for the Spotify MacroBoard, including Arduino IDE installation, board configuration, and library dependencies.Documentation Index
Fetch the complete documentation index at: https://mintlify.com/benz206/SpotifyMacroBoard/llms.txt
Use this file to discover all available pages before exploring further.
Prerequisites
Before you begin, ensure you have:- A computer running Windows, macOS, or Linux
- USB cable (USB-C or Micro-USB depending on your ESP32 board)
- Internet connection for downloading libraries
- The Spotify MacroBoard source code
Install Arduino IDE
Download Arduino IDE
Download the latest version of Arduino IDE from the official Arduino website. Version 2.0 or higher is recommended for the best experience.
Configure ESP32 board support
The Spotify MacroBoard uses an ESP32 microcontroller, which requires additional board definitions.Open board manager URL preferences
Navigate to File > Preferences (or Arduino IDE > Settings on macOS).
Add ESP32 board manager URL
In the “Additional Board Manager URLs” field, add:
If you already have other board URLs, separate them with commas or use the button next to the field to add a new line.
Install ESP32 boards
Search for “esp32” and install the esp32 by Espressif Systems package. This may take a few minutes.
Board configuration
Configure the board settings to match the Spotify MacroBoard specifications:| Parameter | Value | Location |
|---|---|---|
| Board | ESP32 Dev Module | Tools > Board |
| CPU Frequency | 240 MHz | Tools > CPU Frequency |
| Flash Frequency | 80 MHz | Tools > Flash Frequency |
| Flash Mode | QIO | Tools > Flash Mode |
| Flash Size | 4 MB | Tools > Flash Size |
| Upload Speed | 921600 | Tools > Upload Speed |
| Partition Scheme | Default | Tools > Partition Scheme |
Install required libraries
The Spotify MacroBoard requires several libraries for display, LED control, and network communication.Open library manager
Navigate to Tools > Manage Libraries or click the library icon in the left sidebar.
Install Adafruit GFX Library
Search for “Adafruit GFX” and install Adafruit GFX Library by Adafruit.This library provides graphics primitives for displays.
Install Adafruit SSD1306
Search for “Adafruit SSD1306” and install Adafruit SSD1306 by Adafruit.This library drives the OLED display used in the MacroBoard.
The WiFi, WiFiClientSecure, and Wire libraries are built into the ESP32 board package and don’t need separate installation.
Library summary
| Library | Purpose | Used For |
|---|---|---|
| Adafruit_GFX | Graphics primitives | Drawing text and shapes on OLED |
| Adafruit_SSD1306 | OLED display driver | 128x64 OLED display control |
| FastLED | LED control | WS2812B RGB LED strip |
| WiFi | Network connectivity | Connecting to WiFi network |
| WiFiClientSecure | HTTPS requests | Secure API communication |
| Wire | I2C communication | OLED display communication |
Connect your ESP32
Install drivers (if needed)
Windows users may need to install CP210x or CH340 USB drivers depending on your ESP32 board variant. Check your board documentation.
Select the port
In Arduino IDE, go to Tools > Port and select the port that corresponds to your ESP32 (usually labeled as “CP2102” or “CH340” on Windows, or “/dev/cu.usbserial” on macOS).
Open the Spotify MacroBoard code
Download the source code
Clone or download the Spotify MacroBoard source code repository to your computer.
Open the sketch
In Arduino IDE, go to File > Open and navigate to the
src/src.ino file in the source code directory.Next steps
Now that your development environment is set up, proceed to configure your credentials and network settings:Configuration
Configure WiFi credentials, API password, and server certificate