Peas Germination

💡 Lutron Smart Lights Integration

Control your Lutron Caseta smart lights with voice commands through your Apple Watch. Say things like "turn on the living room lights" or "dim the bedroom to 50%".

How It Works

The Lutron Caseta Smart Bridge only accepts connections from your local network. To control your lights from anywhere (including through Peas on your watch), you need a small relay program running on a computer in your home.

┌─────────────────┐      WebSocket      ┌─────────────────┐
│   peas.watch    │◄──────────────────►│  Local Relay    │
│   (Cloud)       │                     │  (Your Mac/PC)  │
└─────────────────┘                     └────────┬────────┘
                                                 │ Local
                                                 │ Network
                                        ┌────────▼────────┐
                                        │  Lutron Bridge  │
                                        │  192.168.x.x    │
                                        └─────────────────┘

Setup Instructions

1 Prerequisites

• Lutron Caseta Smart Bridge - The white hub that connects to your router (not the Basic Bridge)
• Mac or PC - A computer on your home network that stays on (or can wake for this)
• Node.js 18+ - Download from nodejs.org
• Python 3.9+ - For the pairing tool

2 Find Your Bridge IP Address

Your Lutron bridge needs a static IP address. Find it in one of these ways:

• Open the Lutron app → Settings → Advanced → Network Settings
• Check your router's admin page for connected devices (look for "Lutron")
• Use a network scanner like "Fing" app on your phone

3 Install the Pairing Tool

The Lutron bridge requires certificate authentication. Install the pairing tool:

# Install the Python pairing library
pip3 install pylutron-caseta

4 Pair with Your Bridge

Run the pairing tool (replace with your bridge IP):

# On Mac
~/Library/Python/3.9/bin/lap-pair 192.168.0.6

# On Linux
~/.local/bin/lap-pair 192.168.0.6

# On Windows
python -m pylutron_caseta.cli pair 192.168.0.6

After successful pairing, you'll have certificate files in:

• Mac/Linux: ~/.pylutron_caseta/
• Windows: %USERPROFILE%\.pylutron_caseta\

5 Download the Relay Script

Download the Peas Lutron Relay from GitHub:

# Clone the relay
git clone https://github.com/peas-watch/lutron-relay.git
cd lutron-relay

# Or download directly
curl -L https://peas.watch/downloads/lutron-relay.zip -o lutron-relay.zip
unzip lutron-relay.zip
cd lutron-relay

6 Configure the Relay

Create a configuration file lutron-config.json:

{
  "bridgeIp": "192.168.0.6",
  "peasToken": "YOUR_AUTH_TOKEN"
}

To get your auth token:

1. Log into peas.watch
2. Open browser Developer Tools (F12 or Cmd+Option+I)
3. Go to the Console tab
4. Paste this command and press Enter:

document.cookie.split("; ").find(c => c.startsWith("authToken="))?.split("=")[1]

Copy the token that appears and paste it in your config file.

7 Install Dependencies & Run

# Install Node.js dependencies
npm install

# Start the relay
npm start

🫛 Peas Lutron Relay v1.0.0

📋 Loaded config for bridge at 192.168.0.6
📜 Loading certificates from pylutron_caseta config...
🌉 Connecting to Lutron bridge at 192.168.0.6:8081...
✅ Connected to Lutron bridge
🌐 Connecting to Peas.watch...
✅ Connected to Peas.watch

🎉 Relay is running! Lights can now be controlled from peas.watch

8 Run Automatically on Startup (Optional)

To have the relay start automatically when your Mac boots:

# Create a Launch Agent
cat > ~/Library/LaunchAgents/com.peas.lutron-relay.plist << 'EOF'
<?xml version="1.0" encoding="UTF-8"?>
<!DOCTYPE plist PUBLIC "-//Apple//DTD PLIST 1.0//EN" 
  "http://www.apple.com/DTDs/PropertyList-1.0.dtd">
<plist version="1.0">
<dict>
    <key>Label</key>
    <string>com.peas.lutron-relay</string>
    <key>ProgramArguments</key>
    <array>
        <string>/usr/local/bin/node</string>
        <string>relay.js</string>
    </array>
    <key>WorkingDirectory</key>
    <string>/Users/YOUR_USERNAME/lutron-relay</string>
    <key>RunAtLoad</key>
    <true/>
    <key>KeepAlive</key>
    <true/>
    <key>StandardOutPath</key>
    <string>/tmp/peas-lutron-relay.log</string>
    <key>StandardErrorPath</key>
    <string>/tmp/peas-lutron-relay.log</string>
</dict>
</plist>
EOF

# Replace YOUR_USERNAME with your actual username

# Load the service
launchctl load ~/Library/LaunchAgents/com.peas.lutron-relay.plist

# Check if running
launchctl list | grep peas

# View logs
tail -f /tmp/peas-lutron-relay.log

9 Test It!

Once the relay is running:

1. Go to peas.watch/lights to see your lights
2. Or use voice commands: "Hey Peas, turn on the kitchen lights"
3. Or from your Apple Watch, tap the lights icon

~/Library/Python/3.9/bin/lap-pair YOUR_BRIDGE_IP