{"id":15353598,"url":"https://github.com/mifi/telldus-api","last_synced_at":"2025-09-10T03:35:12.667Z","repository":{"id":53496628,"uuid":"107867402","full_name":"mifi/telldus-api","owner":"mifi","description":"Node.js interface for Telldus Live and Telldus Local API","archived":false,"fork":false,"pushed_at":"2024-07-07T10:25:54.000Z","size":287,"stargazers_count":18,"open_issues_count":2,"forks_count":7,"subscribers_count":4,"default_branch":"master","last_synced_at":"2025-03-27T23:41:52.984Z","etag":null,"topics":["api","home-automation","remote-control","telldus-api","telldus-live","telldus-local","tellstick"],"latest_commit_sha":null,"homepage":null,"language":"JavaScript","has_issues":true,"has_wiki":null,"has_pages":null,"mirror_url":null,"source_name":null,"license":"mit","status":null,"scm":"git","pull_requests_enabled":true,"icon_url":"https://github.com/mifi.png","metadata":{"files":{"readme":"README.md","changelog":null,"contributing":null,"funding":".github/FUNDING.yml","license":"LICENSE","code_of_conduct":null,"threat_model":null,"audit":null,"citation":null,"codeowners":null,"security":null,"support":null,"governance":null,"roadmap":null,"authors":null,"dei":null,"publiccode":null,"codemeta":null},"funding":{"github":"mifi","custom":"https://mifi.no/thanks","liberapay":"mifi"}},"created_at":"2017-10-22T13:17:51.000Z","updated_at":"2024-12-26T13:04:06.000Z","dependencies_parsed_at":"2024-06-19T13:33:45.733Z","dependency_job_id":"4661439d-e964-49f8-9d3e-e1ebd6dd09a7","html_url":"https://github.com/mifi/telldus-api","commit_stats":{"total_commits":27,"total_committers":4,"mean_commits":6.75,"dds":"0.40740740740740744","last_synced_commit":"0477e7d0990f47d609247f3da03e7e8c23e5b903"},"previous_names":[],"tags_count":4,"template":false,"template_full_name":null,"repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/mifi%2Ftelldus-api","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/mifi%2Ftelldus-api/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/mifi%2Ftelldus-api/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/mifi%2Ftelldus-api/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/mifi","download_url":"https://codeload.github.com/mifi/telldus-api/tar.gz/refs/heads/master","host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":248665748,"owners_count":21142123,"icon_url":"https://github.com/github.png","version":null,"created_at":"2022-05-30T11:31:42.601Z","updated_at":"2022-07-04T15:15:14.044Z","host_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub","repositories_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories","repository_names_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repository_names","owners_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners"}},"keywords":["api","home-automation","remote-control","telldus-api","telldus-live","telldus-local","tellstick"],"created_at":"2024-10-01T12:14:34.378Z","updated_at":"2025-04-14T10:33:19.216Z","avatar_url":"https://github.com/mifi.png","language":"JavaScript","funding_links":["https://github.com/sponsors/mifi","https://mifi.no/thanks","https://liberapay.com/mifi"],"categories":[],"sub_categories":[],"readme":"# telldus-api\n\nNode.js interface for [Telldus Live API](http://api.telldus.com/) and [Telldus Local API](https://developer.telldus.com/blog/2016/05/24/local-api-for-tellstick-znet-lite-beta-now-in-public-beta). 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.\n\n## Install\n```\nnpm install telldus-api\n```\n\n# Live usage\n- You will need a Telldus Live account with configured devices and and OAuth tokens.\n- Log in to your Live account, go to http://api.telldus.com/ and `Generate a private token for my user only`.\n\n```\nconst { LiveApi } = require('telldus-api');\n\nconst api = new LiveApi({\n  key: '...', // publicKey\n  secret: '...', // privateKey\n  tokenKey: '...', // token\n  tokenSecret: '...', // tokenSecret\n});\n\nconst devices = await api.listDevices();\nconsole.log(devices);\n```\n\n# Local usage\nTellStick ZNet Lite can be controlled via a similar API directly via HTTP.\nFor more info, see [this link](https://developer.telldus.com/blog/2016/05/24/local-api-for-tellstick-znet-lite-beta-now-in-public-beta).\n\n- Find the IP address of your TellStick device\n- Install [telldus-local-auth](https://github.com/mifi/telldus-local-auth): `npm i -g telldus-local-auth`\n- Run in a terminal `telldus-local-auth \u003cIP OF YOUR DEVICE\u003e appname` and follow instructions. `appname` can be set to whatever you want.\n- Note the returned token.\n\n```\nconst { LocalApi } = require('telldus-api');\n\nconst api = new LocalApi({\n  host: '...', // Host name or IP address of your device\n  accessToken: '...', // The access token you got from telldus-local-auth\n});\n\nconst devices = await api.listDevices();\nconsole.log(devices);\n```\n\nThe accessToken will be auto refreshed as long as there are API calls.\n\n# API\nSee `class Api` in [index.js](https://github.com/mifi/telldus-api/blob/master/index.js)\n\n# Links\n- https://github.com/jchnlemon/homebridge-telldus\n- https://github.com/mifi/telldus-local-auth\n","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fmifi%2Ftelldus-api","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Fmifi%2Ftelldus-api","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fmifi%2Ftelldus-api/lists"}