Package Exports

This package does not declare an exports field, so the exports above have been automatically detected and optimized by JSPM instead. If any package subpath is missing, it is recommended to post an issue to the original package (node-kasa) to support the "exports" field. If that is not possible, create a JSPM override to customize the exports field for this package.

Readme

node-kasa

Node.js API for TP-Link Kasa and Tapo devices

This is a JavaScript/Node.js port of the popular python-kasa library, maintaining 1:1 API compatibility.

Features

Support for TP-Link Kasa and Tapo devices
Device discovery on local network
Control smart plugs, bulbs, light strips, switches, and more
Energy monitoring for supported devices
Async/await support throughout
Same API as python-kasa for easy migration

Installation

npm install node-kasa

Quick Start

import { Discover } from 'node-kasa';

// Discover devices on your network
const devices = await Discover.discover();
console.log(`Found ${Object.keys(devices).length} devices`);

// Connect to a specific device
const device = await Discover.discoverSingle('192.168.1.100');
await device.update();

console.log(`Device: ${device.alias}`);
console.log(`Model: ${device.model}`);
console.log(`Is On: ${device.isOn}`);

// Turn device on/off
await device.turnOn();
await device.turnOff();

Device Types

Smart Plugs

import { iot } from 'node-kasa';

const plug = new iot.IotPlug('192.168.1.100');
await plug.update();

await plug.turnOn();
await plug.turnOff();
console.log(plug.isOn);

Smart Bulbs

import { iot } from 'node-kasa';

const bulb = new iot.IotBulb('192.168.1.101');
await bulb.update();

// Control brightness (0-100)
await bulb.setBrightness(50);

// Control color (if supported)
await bulb.setHsv(120, 100, 100); // Green

// Control color temperature (if supported)
await bulb.setColorTemp(3000);

Authentication

For newer devices that require authentication:

import { Discover, Credentials } from 'node-kasa';

const credentials = new Credentials('username@example.com', 'password');
const devices = await Discover.discover({ credentials });

API Documentation

This library maintains the same API as python-kasa:

Device - Base device class
Discover - Device discovery utilities
iot.* - IoT device classes (legacy protocol)
smart.* - Smart device classes (newer protocol)
Credentials - Authentication credentials

Development

# Install dependencies
npm install

# Run tests
npm test

# Run linting
npm run lint

# Fix linting issues
npm run lint:fix

License

GPL-3.0-or-later

Contributing

This project maintains API compatibility with python-kasa. Please ensure any changes preserve the same method signatures and behavior.