{"id":21291697,"url":"https://github.com/jdtsmith/mqttthing-ikeablindz2m","last_synced_at":"2025-03-15T16:34:29.368Z","repository":{"id":66869987,"uuid":"301839659","full_name":"jdtsmith/mqttthing-ikeaBlindZ2M","owner":"jdtsmith","description":"A Codec for homebridge-mqttthing supporting Ikea blinds via Zigbee2MQTT","archived":false,"fork":false,"pushed_at":"2020-10-07T16:43:14.000Z","size":16,"stargazers_count":3,"open_issues_count":0,"forks_count":0,"subscribers_count":4,"default_branch":"main","last_synced_at":"2025-01-22T06:24:20.629Z","etag":null,"topics":[],"latest_commit_sha":null,"homepage":null,"language":"JavaScript","has_issues":true,"has_wiki":null,"has_pages":null,"mirror_url":null,"source_name":null,"license":"apache-2.0","status":null,"scm":"git","pull_requests_enabled":true,"icon_url":"https://github.com/jdtsmith.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,"governance":null,"roadmap":null,"authors":null,"dei":null,"publiccode":null,"codemeta":null}},"created_at":"2020-10-06T19:55:36.000Z","updated_at":"2021-05-06T08:52:20.000Z","dependencies_parsed_at":"2023-05-12T09:45:16.354Z","dependency_job_id":null,"html_url":"https://github.com/jdtsmith/mqttthing-ikeaBlindZ2M","commit_stats":null,"previous_names":[],"tags_count":0,"template":false,"template_full_name":null,"repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/jdtsmith%2Fmqttthing-ikeaBlindZ2M","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/jdtsmith%2Fmqttthing-ikeaBlindZ2M/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/jdtsmith%2Fmqttthing-ikeaBlindZ2M/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/jdtsmith%2Fmqttthing-ikeaBlindZ2M/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/jdtsmith","download_url":"https://codeload.github.com/jdtsmith/mqttthing-ikeaBlindZ2M/tar.gz/refs/heads/main","host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":243760590,"owners_count":20343658,"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":[],"created_at":"2024-11-21T13:39:28.993Z","updated_at":"2025-03-15T16:34:29.343Z","avatar_url":"https://github.com/jdtsmith.png","language":"JavaScript","funding_links":[],"categories":[],"sub_categories":[],"readme":"# mqttthing-ikeaBlindZ2M\nA Codec for [homebridge-mqttthing](https://github.com/arachnetech/homebridge-mqttthing) supporting Ikea blinds via [Zigbee2MQTT](https://github.com/Koenkk/zigbee2mqtt)\n\nThis simple codec supports operating IKEA blinds (like Fytur) using Zigbee2MQTT to translate commands to and from the blinds into MQTT messages, which mqttthing receives, and this codec encodes and decodes.  Specifically, this codec handles:\n\n- Rate limiting new position targets, as when sliding the blinds up and down in Home or watch interface.\n- Working around Zigbee2MQTT's default behavior of \"optimistically\" and immediately publishing the target position as the current position. New versions of Zigbee2MQTT will include the option to set `optimistic: false` for a device to disable this, and this is strongly recommended (see [this discussion](https://github.com/Koenkk/zigbee2mqtt/issues/4524)). \n- Keeping the Homekit interface in sync for moves made outside of Homekit (e.g. with remote or buttons on blinds). \n\n## Installation:\n\nInstalling is simply a matter of [downloading](https://github.com/jdtsmith/mqttthing-ikeaBlindZ2M/archive/main.zip), then dropping the file `ikeaBlindZ2M.js` into your `homebridge` directory (wherever the `config.json` file is).  \n\n## Configuration:\n\nBlinds can be configured in `config.json` as accessories:\n\n```\n{\n  \"accessory\": \"mqttthing\",\n  \"name\": \"Blind Name\",\n  \"codec\": \"ikeaBlindZ2M.js\",\n  \"topicBase\": \"zigbee2mqtt/ikea_blind_topic\",\n  \"maxRate\": number \u003e 0 [OPTIONAL],\n  \"targetConsolidate\": number \u003e 0 [OPTIONAL]\n}\n```\n\nA couple of optional parameters can also be included:\n\n```\nmaxRate: The maximum rate (in %/sec) that a blind can move [default:\n  4 %/sec].  Used to detect spurious location udpates from\n  Zigbee2MQTT.  Can be set to 0 to disable.  Not needed if optimistic: \n  false is configured for the device. \n\ntargetConsolidate: Limit rapid-fire target setting by insisting no\n  additional target is specified for this amount of time (in ms)\n  afterwards before setting it (default: 500 ms).\n```\n","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fjdtsmith%2Fmqttthing-ikeablindz2m","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Fjdtsmith%2Fmqttthing-ikeablindz2m","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fjdtsmith%2Fmqttthing-ikeablindz2m/lists"}