/install living-room-smoke-detector
Living Room Smoke Detector
A simple, focused smoke and fire detection system that monitors the living room ALPSTUGA air sensor via the Dirigera hub.
What It Does
- Queries Dirigera directly every 5 minutes (not from database)
- Simple state only - keeps just the latest reading, no history
- Detects danger: PM2.5 > 250 µg/m³ OR CO2 > 2000 ppm
- Continuous alert - plays "Attention! Abnormal smoke level detected" on Mac speaker
- Loops until cleared - keeps playing every 5 seconds until air quality normalizes
- Backup smoke alarm - works alongside your regular smoke detector
Setup
1. Copy Alert Sound (optional)
If you already have the alert sound from the air monitor skill:
cp ~/.openclaw/workspace/skills/living-room-air-monitor/data/smoke_alert_message.mp3 \
~/.openclaw/workspace/skills/living-room-smoke-detector/data/alert.mp3
Otherwise it will auto-generate on first run.
2. Cron Setup
Add to crontab to check every 5 minutes:
*/5 * * * * /opt/homebrew/bin/python3 /Users/macmini/.openclaw/workspace/skills/living-room-smoke-detector/scripts/smoke_detector.py >> /tmp/smoke_detector.log 2>&1
Usage
Manual Check
python3 ~/.openclaw/workspace/skills/living-room-smoke-detector/scripts/smoke_detector.py
View Status
# Latest reading
cat ~/.openclaw/workspace/skills/living-room-smoke-detector/data/detector_state.json
# Log
tail -f /tmp/smoke_detector.log
How It Works
- Cron triggers every 5 minutes
- Fetches data directly from Dirigera hub
- Checks thresholds:
- PM2.5 > 250 µg/m³ (smoke particles)
- CO2 > 2000 ppm (combustion byproduct)
- If danger detected:
- Saves state (alert_active = true)
- Enters alert loop
- Plays alert sound every 5 seconds
- Re-checks sensor between plays
- Exits loop when air clears
- If normal: Updates state and exits
State File
data/detector_state.json:
{
"latest_reading": {
"pm25": 3,
"co2": 525,
"time": "2026-02-25T20:30:00"
},
"alert_active": false,
"last_check": "2026-02-25T20:30:00"
}
Alert Behavior
When danger is detected:
- Mac speaker plays: "Attention! Abnormal smoke level detected"
- Waits 5 seconds
- Checks sensor again
- Repeats until PM2.5 ≤ 250 AND CO2 ≤ 2000
- Press Ctrl+C to stop manually if needed
Files
| File | Purpose |
|---|---|
scripts/smoke_detector.py |
Main detection script |
data/alert.mp3 |
Alert sound file |
data/detector_state.json |
Latest reading and status |
Dependencies
- Python 3.x
- Dirigera hub access (192.168.1.100)
- Auth token at
~/.openclaw/workspace/.dirigera_token - macOS
afplay(built-in) sayandffmpeg(for alert generation)
Differences from Air Monitor Skill
| Feature | Air Monitor | Smoke Detector |
|---|---|---|
| Data storage | Full SQLite database | Latest reading only |
| Query source | Database | Dirigera directly |
| Frequency | Every 2 min | Every 5 min |
| Purpose | History + charts | Immediate alerting |
| Alert | Single play | Continuous loop |
| Complexity | Multi-feature | Single-purpose |
Use both for complete coverage: air monitor for data logging, smoke detector for focused alerting.
- Make sure OpenClaw is installed (local or Docker)
- Run the install command in chat:
/install living-room-smoke-detector - After installation, invoke the skill by name or use
/living-room-smoke-detector - Provide required inputs per the skill's parameter spec and get structured output
What is Living Room Smoke Detector?
Simple smoke/fire detector for living room. Queries Dirigera air sensor every 5 minutes, detects dangerous PM2.5 over 250 or CO2 over 2000 levels, and broadc... It is an AI Agent Skill for Claude Code / OpenClaw, with 516 downloads so far.
How do I install Living Room Smoke Detector?
Run "/install living-room-smoke-detector" in the OpenClaw or Claude Code chat to install it in one step — no extra setup required.
Is Living Room Smoke Detector free?
Yes, Living Room Smoke Detector is completely free (open-source). You can download, install and use it at no cost.
Which platforms does Living Room Smoke Detector support?
Living Room Smoke Detector is cross-platform and runs anywhere OpenClaw / Claude Code is available (cross-platform).
Who created Living Room Smoke Detector?
It is built and maintained by Igor (@maverick-2); the current version is v1.0.0.