{"id":13799776,"url":"https://github.com/dnknth/node-red-contrib-fritzapi","last_synced_at":"2025-05-13T08:32:00.641Z","repository":{"id":45186117,"uuid":"173176421","full_name":"dnknth/node-red-contrib-fritzapi","owner":"dnknth","description":"Home automation node for Fritz!Box, Fritz!DECT and FRITZ!Powerline devices.","archived":true,"fork":false,"pushed_at":"2022-07-18T20:28:17.000Z","size":119,"stargazers_count":18,"open_issues_count":3,"forks_count":16,"subscribers_count":10,"default_branch":"master","last_synced_at":"2025-04-25T23:35:39.147Z","etag":null,"topics":["fritzbox","node-red","node-red-contrib","nodejs"],"latest_commit_sha":null,"homepage":"","language":"JavaScript","has_issues":false,"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/dnknth.png","metadata":{"files":{"readme":"README.md","changelog":null,"contributing":null,"funding":null,"license":"LICENSE","code_of_conduct":null,"threat_model":null,"audit":null,"citation":null,"codeowners":null,"security":null,"support":null}},"created_at":"2019-02-28T19:42:09.000Z","updated_at":"2024-09-01T11:23:33.000Z","dependencies_parsed_at":"2022-09-17T04:21:18.234Z","dependency_job_id":null,"html_url":"https://github.com/dnknth/node-red-contrib-fritzapi","commit_stats":{"total_commits":47,"total_committers":9,"mean_commits":5.222222222222222,"dds":0.574468085106383,"last_synced_commit":"5de4b1b9d1479a6b1edda45ae628073d60f20c57"},"previous_names":[],"tags_count":0,"template":false,"template_full_name":null,"repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/dnknth%2Fnode-red-contrib-fritzapi","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/dnknth%2Fnode-red-contrib-fritzapi/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/dnknth%2Fnode-red-contrib-fritzapi/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/dnknth%2Fnode-red-contrib-fritzapi/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/dnknth","download_url":"https://codeload.github.com/dnknth/node-red-contrib-fritzapi/tar.gz/refs/heads/master","host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":253903856,"owners_count":21981761,"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":["fritzbox","node-red","node-red-contrib","nodejs"],"created_at":"2024-08-04T00:01:05.989Z","updated_at":"2025-05-13T08:32:00.385Z","avatar_url":"https://github.com/dnknth.png","language":"JavaScript","funding_links":[],"categories":["Nodes"],"sub_categories":["Smarthome"],"readme":"# node-red-contrib-fritzapi\n\n**This project is no longer actively maintained. Feel free to fork it, new maintainers are welcome.**\n\nControl your smart home DECT devices through an AVM Fritz!Box with node-RED.\n\nThese nodes are a simple Node-RED wrapper for [andig's](https://github.com/andig) ever-popular\n[fritzapi](https://www.npmjs.com/package/fritzapi), see there a for feature description.\n\n## Installation\n\nThe recommended way is to install directly from Node-RED under `Manage palette`.\n\n## Configuration\n\nDepending on your FRITZ!Box configuration, a user name may be needed. If your box is configured for password-only\nadmin access, leave the user name blank and only provide the admin password. Make sure that smart home control is\nenabled on the FRITZ!Box.\n\n## Usage\n\nThe packages contains `thermostat`, `switch`, `bulb`, `blind` nodes under the `advanced` section in the palette.\n\nThermostats, switches and blinds expect an actuator identification number `AIN` as `ain` or `topic` on the input message.\n\nIf both `ain` and `topic` are provided, `ain` has precedence.\n\nNodes have an (optional) pre-set action. It can be overriden with the `action` attribute on input messages.\nSee [fritzapi](https://www.npmjs.com/package/fritzapi) for a list of supported action names.\n\nAny payload is accepted for information retrieval.\n\n* For switch updates, send the desired boolean value\n(on or off).\n* For thermostat updates, send the target temperature or adjustment in degrees Celsius. `on` and `off` may also be used to switch thermostats on or off.\n  * There are two special cases: `setTempComfort` (Set to day temperature) and `setTempNight` (Set to night temperature)\ndo not expect a temperature as payload, because they set the *target* temperature to the day / night preset.\n  * An [example flow](examples/Fritz%20HTTP%20API%20Example%20Flow.json) demonstrates usage of the `thermostat` node.\n* Bulbs can be set to a given brightness level, color or color temperature. See the node documenation for details.\n* Blinds be set to a desired level, or opened or closed.\nSee the node documenation for details.\n\nAdjustments are only made if the desired state differs from the actual state. All updates are logged.\n\nAll actions output the requested or updated value.\n\n## Troubleshooting\n\nA popular pitfall seems to be that the Fritz!Box UI shows imcomplete AINs for various [bulbs](https://github.com/dnknth/node-red-contrib-fritzapi/issues/27#issuecomment-953936018) and [blinds](https://github.com/dnknth/node-red-contrib-fritzapi/issues/26). If the device does not respond, try appending `-1` to the AIN.\n\n## Still stuck?\n\nSwitches, bulbs and blinds were tested by contributors, as I do not own any. All feedback appreciated, but please check the [relevant issues](https://github.com/dnknth/node-red-contrib-fritzapi/issues?q=is%3Aissue+is%3Aclosed) before opening new ones.\n\n## Credits\n\nKudos to [andig](https://github.com/andig) for [fritzapi](https://www.npmjs.com/package/fritzapi).\nAlso, substantial parts of the low-level interface were also written by [andig](https://github.com/andig) for\n[homebridge-fritz](https://www.npmjs.com/package/homebridge-fritz). Thanks for the wizardry!\n","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fdnknth%2Fnode-red-contrib-fritzapi","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Fdnknth%2Fnode-red-contrib-fritzapi","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fdnknth%2Fnode-red-contrib-fritzapi/lists"}