LB130 Web Interface

A web interface for controlling the TP-Link LB130 smart bulb.

Requirements

• Node.js 24+

Setup

npm install

Set the bulb's IP or hostname in config.json:

{
  "bulb": "192.168.1.x"
}

Development

Start the mock bulb server (simulates a real LB130 over UDP):

npm run mock

Start the Vite dev server (proxies /api to the Express server):

npm run dev

Start the Express API server:

npm start

Production

Build the frontend:

npm run build

Start the server:

npm start

The app is then available at http://localhost:3000.

Docker

docker compose up

By default, BULB_IP is set to host.docker.internal (the host machine — useful when running the mock locally). Override it for a real bulb:

BULB_IP=192.168.1.x docker compose up

Linux: Docker Desktop's host.docker.internal requires adding extra_hosts: ["host.docker.internal:host-gateway"] to the compose service, or uncommenting network_mode: host.

Credits

• tplink-lightbulb by konsumer
• lightbulb.svg by Alex Zaworski