Skip to content
This repository has been archived by the owner on Oct 22, 2019. It is now read-only.
forked from mifi/telldus-api

Node.js interface for Telldus Live and Telldus Local API

License

Notifications You must be signed in to change notification settings

ingvaldlorentzen/telldus-api

 
 

Folders and files

NameName
Last commit message
Last commit date

Latest commit

 

History

14 Commits
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 

Repository files navigation

telldus-api

Node.js interface for Telldus Live API and Telldus Local API. Since their APIs are similar, I added support for both. All API methods are promise based. Both LiveApi and LocalApi inherit from the same class Api which has the same methods. However not all methods are implemented or make sense on LocalApi.

Install

⚠️ Requires node 8.3 or greater.

npm install telldus-api

Live usage

  • You will need a Telldus Live account with configured devices and and OAuth tokens.
  • Log in to your Live account, go to http://api.telldus.com/ and Generate a private token for my user only.
const { LiveApi } = require('telldus-api');

const api = new LiveApi({
  key: '...', // publicKey
  secret: '...', // privateKey
  tokenKey: '...', // token
  tokenSecret: '...', // tokenSecret
});

const devices = await api.listDevices();
console.log(devices);

Local usage

TellStick ZNet Lite can be controlled via a similar API directly via HTTP. For more info, see this link.

  • Find the IP address of your TellStick device
  • Install telldus-local-auth: npm i -g telldus-local-auth
  • Run in a terminal telldus-local-auth <IP OF YOUR DEVICE> appname and follow instructions. appname can be set to whatever you want.
  • Note the returned token.
const { LocalApi } = require('telldus-api');

const api = new LocalApi({
  host: '...', // Host name or IP address of your device
  accessToken: '...', // The access token you got from telldus-local-auth
});

const devices = await api.listDevices();
console.log(devices);

The accessToken will be auto refreshed as long as there are API calls.

API

See class Api in index.js

Links

About

Node.js interface for Telldus Live and Telldus Local API

Resources

License

Stars

Watchers

Forks

Packages

No packages published

Languages

  • JavaScript 100.0%