SRS IT
328a607e28
- Root README: add Linux x64 + ARM64 download targets, update release assets table, document background scheduler differences per OS, add wemo-core shared package description, use repo name dibby-wemo-manager - apps/desktop README: full rewrite covering Windows installer/portable, Linux AppImage/.deb/.rpm (x64 + ARM64), all build commands per OS, data storage paths per OS, requirements table - packages/wemo-core: new README documenting all exports, constants, helper functions, day number convention, sun sentinel codes - about.html: fix version string from "2.0" to "2.0.0" Co-Authored-By: Claude Sonnet 4.6 <noreply@anthropic.com>
249 lines
7.6 KiB
Markdown
249 lines
7.6 KiB
Markdown
# Dibby Wemo Manager
|
|
|
|
**Local Wemo control — no Belkin cloud required.**
|
|
|
|
Dibby Wemo Manager gives you full local control of Belkin Wemo smart switches and plugs from two interfaces:
|
|
|
|
| Component | Description |
|
|
|---|---|
|
|
| 🖥️ **Desktop App** | Cross-platform Electron app (Windows + Linux) — device dashboard, power control, scheduling |
|
|
| 🏠 **Homebridge Plugin** | HomeKit integration with custom scheduling UI inside Homebridge |
|
|
|
|
Both share the same local-network Wemo protocol (UPnP/SOAP) and the same DWM scheduling engine. No Belkin account, no cloud dependency, no internet required.
|
|
|
|
---
|
|
|
|
## Repository Layout
|
|
|
|
```
|
|
dibby-wemo-manager/
|
|
├── apps/
|
|
│ └── desktop/ # Electron desktop app (Windows + Linux)
|
|
├── packages/
|
|
│ ├── homebridge-plugin/ # homebridge-dibby-wemo Homebridge plugin
|
|
│ └── wemo-core/ # Shared Wemo protocol helpers (internal)
|
|
└── package.json # npm workspaces root
|
|
```
|
|
|
|
---
|
|
|
|
## Quick Start
|
|
|
|
### Desktop App
|
|
|
|
Download the latest installer from [Releases](../../releases):
|
|
|
|
**Windows:**
|
|
- **`Dibby Wemo Manager Setup 2.0.0.exe`** — NSIS installer (recommended)
|
|
- **`Dibby Wemo Manager 2.0.0.exe`** — Portable single-file executable
|
|
|
|
**Linux (x64):**
|
|
- **`Dibby Wemo Manager-2.0.0.AppImage`** — Universal AppImage, runs anywhere
|
|
- **`dibby-wemo-manager_2.0.0_amd64.deb`** — Debian / Ubuntu
|
|
- **`dibby-wemo-manager-2.0.0.x86_64.rpm`** — Fedora / RHEL
|
|
|
|
**Linux (ARM64 — Raspberry Pi 4/5):**
|
|
- **`Dibby Wemo Manager-2.0.0-arm64.AppImage`**
|
|
- **`dibby-wemo-manager_2.0.0_arm64.deb`**
|
|
|
|
Run the installer (Windows) or AppImage (Linux). Wemo devices are discovered automatically via SSDP on your local network.
|
|
|
|
### Homebridge Plugin
|
|
|
|
```bash
|
|
npm install -g homebridge-dibby-wemo
|
|
```
|
|
|
|
Then add to your Homebridge `config.json`:
|
|
|
|
```json
|
|
{
|
|
"platforms": [
|
|
{
|
|
"platform": "DibbyWemo",
|
|
"name": "DibbyWemo"
|
|
}
|
|
]
|
|
}
|
|
```
|
|
|
|
Restart Homebridge. Devices appear in HomeKit automatically.
|
|
|
|
---
|
|
|
|
## Features
|
|
|
|
### 🖥️ Desktop App
|
|
|
|
- **Device dashboard** — real-time on/off status for all Wemo devices on your network
|
|
- **One-click power control** — toggle any device instantly
|
|
- **DWM Rules** — cross-device scheduling engine:
|
|
- **Schedule** — turn devices on/off at specific times on selected days
|
|
- **Countdown** — active-window timer (on at sunset, off at midnight, etc.)
|
|
- **Away Mode** — randomised on/off simulation while you're away
|
|
- **Always On** — enforce a device stays on; auto-corrects within 10 seconds
|
|
- **Trigger** — IFTTT-style: when device A changes state, control device B
|
|
- **Native firmware rules** — read, toggle and delete rules stored on the Wemo device itself
|
|
- **Background scheduler** — keeps rules firing even when the GUI is closed
|
|
- Windows: native Windows service (`DibbyWemoService`)
|
|
- Linux: background process, runs while app is in system tray
|
|
- **Web remote** — optional local web interface accessible from your phone
|
|
- **Sunrise/sunset support** — location-aware scheduling via city search
|
|
|
|
**Platforms:** Windows 10+ (x64) · Linux x64 · Linux ARM64 (Raspberry Pi 4/5)
|
|
|
|
### 🏠 Homebridge Plugin
|
|
|
|
- All Wemo devices registered as **HomeKit switches**
|
|
- Custom Homebridge UI panel with five tabs:
|
|
- **Devices** — live device list with on/off toggle
|
|
- **DWM Rules** — full scheduling CRUD (same rule types as desktop)
|
|
- **Device Rules** — native firmware rule management
|
|
- **Settings** — city/location search for sunrise/sunset times
|
|
- **Help** — built-in documentation
|
|
- **Scheduler health monitor** — green/amber/red status bar shows scheduler state in real time
|
|
- **Catch-up on restart** — rules missed while Homebridge was restarting fire automatically on startup
|
|
- No cloud required; all communication is local SOAP/UPnP
|
|
|
|
---
|
|
|
|
## Supported Devices
|
|
|
|
Tested and confirmed working:
|
|
|
|
| Model | Name |
|
|
|---|---|
|
|
| WLS0403 | Wemo 3-Way Smart Switch |
|
|
| WLS040 | Wemo Light Switch |
|
|
| F7C030 | Wemo Light Switch (older) |
|
|
| F7C027 | Wemo Switch / Mini Smart Plug |
|
|
| F7C029 | Wemo Insight Smart Plug |
|
|
| F7C063 | Wemo Mini Smart Plug v2 |
|
|
|
|
> **Note:** Wemo Dimmer V2 (WDS060) with newer RTOS firmware does not expose the `FetchRules`/`StoreRules` UPnP service. These devices are detected and support on/off control but native firmware rule editing is unavailable.
|
|
|
|
---
|
|
|
|
## Architecture
|
|
|
|
### Wemo Protocol
|
|
|
|
All communication is local UPnP/SOAP over HTTP — no Belkin cloud:
|
|
|
|
| Operation | Method |
|
|
|---|---|
|
|
| Discovery | SSDP M-SEARCH multicast to `239.255.255.250:1900` |
|
|
| Device info | HTTP GET `http://<ip>:<port>/setup.xml` |
|
|
| On/Off | UPnP SOAP `SetBinaryState` / `GetBinaryState` |
|
|
| State query | UPnP SOAP `GetBinaryState` |
|
|
| Native rules | UPnP SOAP `FetchRules` / `StoreRules` (ZIP + SQLite) |
|
|
|
|
### Native Firmware Rules Database
|
|
|
|
The Wemo device stores rules in a SQLite database inside a ZIP archive:
|
|
|
|
1. `FetchRules` returns a URL to download the ZIP
|
|
2. The ZIP contains `temppluginRules.db` (SQLite)
|
|
3. Modify the SQLite, re-ZIP, base64-encode
|
|
4. `StoreRules` uploads the encoded database
|
|
|
|
> **Critical:** `StoreRules` requires the base64 body wrapped in entity-encoded CDATA:
|
|
> `<![CDATA[base64data]]>`
|
|
> Standard XML builders cannot produce this format — the SOAP envelope must be hand-crafted.
|
|
|
|
### DWM Scheduling Engine
|
|
|
|
The DWM (Dibby Wemo Manager) scheduler is a Node.js process that:
|
|
|
|
- Loads rules from a JSON store
|
|
- Ticks every **30 seconds**, reloading rules on each tick (live edits take effect without restart)
|
|
- Pre-schedules events within a **65-second look-ahead window**
|
|
- On startup, catches up any rules missed within the last **10 minutes**
|
|
- Runs a **health monitor** every 10 seconds for AlwaysOn and Trigger rules
|
|
- Writes a **heartbeat** to the store on every tick so the UI can show scheduler status
|
|
|
|
### Shared Core
|
|
|
|
`packages/wemo-core` contains shared constants and utilities (day numbers, time conversions, sunrise/sunset calculator) used by both the desktop app and the Homebridge plugin without duplication. It is an internal npm workspace package, not published to npm.
|
|
|
|
---
|
|
|
|
## Development
|
|
|
|
### Prerequisites
|
|
|
|
- Node.js ≥ 18
|
|
- npm ≥ 9
|
|
|
|
### Install all dependencies
|
|
|
|
```bash
|
|
# From repo root — installs all workspaces
|
|
npm install
|
|
```
|
|
|
|
### Desktop App — dev mode
|
|
|
|
```bash
|
|
cd apps/desktop
|
|
npm run dev
|
|
```
|
|
|
|
### Desktop App — build
|
|
|
|
```bash
|
|
# Windows installer + portable exe
|
|
cd apps/desktop
|
|
npm run build:win
|
|
|
|
# Linux AppImage + .deb + .rpm (x64)
|
|
cd apps/desktop
|
|
npm run build:linux
|
|
|
|
# Linux ARM64 (Raspberry Pi)
|
|
cd apps/desktop
|
|
npm run build:linux:arm64
|
|
|
|
# Windows x64 + Linux x64 in one command
|
|
cd apps/desktop
|
|
npm run build:all
|
|
```
|
|
|
|
Output in `apps/desktop/dist/`.
|
|
|
|
### Homebridge Plugin — install locally
|
|
|
|
```bash
|
|
cd packages/homebridge-plugin
|
|
npm install -g .
|
|
```
|
|
|
|
Then restart Homebridge.
|
|
|
|
---
|
|
|
|
## Release Assets
|
|
|
|
Each [GitHub Release](../../releases) includes:
|
|
|
|
| File | OS | Description |
|
|
|---|---|---|
|
|
| `Dibby Wemo Manager Setup 2.0.0.exe` | Windows | NSIS installer (recommended) |
|
|
| `Dibby Wemo Manager 2.0.0.exe` | Windows | Portable executable |
|
|
| `Dibby Wemo Manager-2.0.0.AppImage` | Linux x64 | Universal AppImage |
|
|
| `dibby-wemo-manager_2.0.0_amd64.deb` | Linux x64 | Debian / Ubuntu package |
|
|
| `dibby-wemo-manager-2.0.0.x86_64.rpm` | Linux x64 | Fedora / RHEL package |
|
|
| `Dibby Wemo Manager-2.0.0-arm64.AppImage` | Linux ARM64 | Raspberry Pi 4/5 AppImage |
|
|
| `dibby-wemo-manager_2.0.0_arm64.deb` | Linux ARM64 | Raspberry Pi OS package |
|
|
| `homebridge-dibby-wemo-1.0.0.tgz` | Any | Homebridge plugin npm package |
|
|
|
|
---
|
|
|
|
## License
|
|
|
|
MIT — see [LICENSE](LICENSE)
|
|
|
|
---
|
|
|
|
*Built by SRS IT. All Wemo communication is local — your device data never leaves your network.*
|