/ Get started — DIY install

Run Rhythm on your own Raspberry Pi.

Flash the free, signed image onto a ~$15 Raspberry Pi Zero — about ten minutes, no terminal required. The iOS app conducts your lights from there. Local, no cloud.

/ DIY — bring your own Pi

Flash your own Pi Zero.

One signed image, any microSD card. About ten minutes from download to a hub breathing on your network — no terminal, no soldering, no cloud.

  • Pi Zero W / 2 W ~$15 board
  • microSD 8 GB or larger
  • USB power micro-USB + cable
  • Card reader to write the image
  1. 01

    Download the image

    Grab sdcard.img.gz. Leave it gzipped — every flasher reads it as-is, no unzipping.

    Download Pi Zero W image signed · latest
  2. 02

    Get a flasher

    Any image writer works. Both are free for macOS, Windows and Linux.

  3. 03

    Pre-set Wi-Fi optional · headless

    In Pi Imager, click the gear (⚙) before writing: set your Wi-Fi SSID + password and the hostname rhythm. The Pi joins your network on first boot — no monitor or keyboard needed.

  4. 04

    Write to the card

    Choose the .img.gz, pick your microSD, hit Flash. The writer verifies automatically — about five minutes.

    Writing erases the card. Double-check you picked the microSD, not your drive.

  5. 05

    Boot the Pi

    Eject, slot the card into the Pi, plug in USB power. The first boot expands the filesystem — the green LED flickers, then steadies once the service is up (~5 min).

  6. 06

    Pair in the app

    Open Rhythm on iOS — it auto-discovers the hub over your local network, then link Hue, Home Assistant or Matter. Want to confirm it first?

    $ open http://rhythm.local:54448
OTA updates after first boot Signed & reproducible Local network only
/01 — The Companion App

The app is the conductor.

  • Solar Designer. Sculpt the day in one gesture.
  • Room Constellation. Each room, its own rhythm.
  • Sleep Schedule. Wake to dawn, fall in embers.
Get the app — Free 4.9 ★★★★★ · iOS · iPadOS · macOS
9:41 ● 100
SOLAR DESIGNER · STUDIO

Holding focus.

11:42
CCT5200K
LUX820
NEXT14:00
Studio5200K · ON
Kitchen4400K · ON
Bedroom2800K · DIM
/02 — Questions

Asked & answered.

/01 Does it work without the cloud? +

Yes — local network only. Set RHYTHM_NO_TELEMETRY=1 to skip the install ping.

/02 Can I switch hardware later? +

Yes. Backup → restore → repoint the app.

/03 What lights do I need? +

Hue, HA, or Matter. Tunable-white gets the full curve.

/04 Which Raspberry Pi do I need? +

A Pi Zero W or Zero 2 W (~$15). A Pi 3, 4, or 5 works too if you already have one.

Flash it. Get on the orbit.