Installation

Use the Raspberry Pi Imager. Choose:

• OS: Raspberry Pi OS Lite (64-bit) — Bookworm
• Storage: your SD card (16 GB minimum; use a reputable brand — SanDisk or Samsung)

Before writing, click the gear icon (Advanced Options) and configure:

• Enable SSH (password authentication)
• Set username and password
• Configure WiFi (SSID + password)
• Set locale / timezone

Write the image to the SD card.

Insert the card into the Pi, attach the Inky display, and power on. Wait ~60 seconds, then SSH in:

ssh yourname@raspberrypi.local
# or use the IP address shown in your router's device list

sudo apt update && sudo apt full-upgrade -y
sudo reboot

Wait for the Pi to reboot, then SSH back in before continuing. Always update before installing — it avoids broken package dependencies and ensures you have the latest kernel/firmware for the Inky SPI driver.

Not pre-installed on Pi OS Lite:

sudo apt install -y git

You need:

• Station ID — visible in the WeatherFlow app under Settings → Stations
• Personal Use Token — generate one at tempestwx.com/account/tokens

bash install.sh

The installer will:

• Install system dependencies
• Enable SPI and I2C hardware interfaces
• Ensure your user is in the spi, i2c, and gpio groups
• Apply the Bookworm SPI chip-select overlay fix
• Create a self-contained Python virtual environment
• Prompt you for your Station ID and API token, saved as ~/secrets.py
• Install a systemd timer that refreshes the display on an adaptive schedule

sudo reboot

The display will update automatically ~2 minutes after boot, then every 15 minutes — more often when rain is likely within the hour, less often overnight.