{"id":26516474,"url":"https://github.com/maxmudjon/homebridge-mijia","last_synced_at":"2025-03-21T07:18:14.186Z","repository":{"id":57265648,"uuid":"90065804","full_name":"Maxmudjon/homebridge-mijia","owner":"Maxmudjon","description":"Mijia plugin for homebridge","archived":false,"fork":false,"pushed_at":"2017-06-08T09:04:46.000Z","size":18,"stargazers_count":49,"open_issues_count":22,"forks_count":7,"subscribers_count":12,"default_branch":"master","last_synced_at":"2025-03-12T06:17:01.982Z","etag":null,"topics":["aqara","battery","gateway","home","homebridge","homebridge-mijia","homekit","mijia","mijia-plugin","smart","smarthome","xiaomi"],"latest_commit_sha":null,"homepage":null,"language":"JavaScript","has_issues":true,"has_wiki":null,"has_pages":null,"mirror_url":null,"source_name":null,"license":null,"status":null,"scm":"git","pull_requests_enabled":true,"icon_url":"https://github.com/Maxmudjon.png","metadata":{"files":{"readme":"README.md","changelog":null,"contributing":null,"funding":null,"license":null,"code_of_conduct":null,"threat_model":null,"audit":null,"citation":null,"codeowners":null,"security":null,"support":null}},"created_at":"2017-05-02T18:35:13.000Z","updated_at":"2024-11-06T02:50:01.000Z","dependencies_parsed_at":"2022-08-25T02:20:51.522Z","dependency_job_id":null,"html_url":"https://github.com/Maxmudjon/homebridge-mijia","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/Maxmudjon%2Fhomebridge-mijia","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/Maxmudjon%2Fhomebridge-mijia/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/Maxmudjon%2Fhomebridge-mijia/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/Maxmudjon%2Fhomebridge-mijia/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/Maxmudjon","download_url":"https://codeload.github.com/Maxmudjon/homebridge-mijia/tar.gz/refs/heads/master","host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":244752347,"owners_count":20504256,"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":["aqara","battery","gateway","home","homebridge","homebridge-mijia","homekit","mijia","mijia-plugin","smart","smarthome","xiaomi"],"created_at":"2025-03-21T07:18:13.685Z","updated_at":"2025-03-21T07:18:14.166Z","avatar_url":"https://github.com/Maxmudjon.png","language":"JavaScript","funding_links":[],"categories":[],"sub_categories":[],"readme":"# homebridge-mijia\n[![npm version](https://badge.fury.io/js/homebridge-mijia.svg)](https://badge.fury.io/js/homebridge-mijia)\n\nMiJia plugin for [HomeBridge](https://github.com/nfarina/homebridge)\n\nThis repository contains the MiJia plugin for homebridge.\n\nMiJia is a ZigBee gateway with a almost all sensors and accessories. Please see the pictures below.\n\n![](https://raw.githubusercontent.com/Maxmudjon/images/master/Mijia-Gate-way-200x200.jpg)\n![](https://raw.githubusercontent.com/Maxmudjon/images/master/Mijia-Honeywell-Smart-Fire-Alarm-200x200.jpg)\n![](https://raw.githubusercontent.com/Maxmudjon/images/master/Mijia-Honeywell-Smart-Gas-Alarm-Detector-CH4-200x200.jpg)\n![](https://raw.githubusercontent.com/Maxmudjon/images/master/Mijia-Light-Control-200x200.jpg)\n![](https://raw.githubusercontent.com/Maxmudjon/images/master/Mijia-Light-Control-Slim-200x200.jpg)\n![](https://raw.githubusercontent.com/Maxmudjon/images/master/Mijia-Body-Sensor-200x200.jpg)\n![](https://raw.githubusercontent.com/Maxmudjon/images/master/Mijia-Door-Window-Sensor-200x200.jpg)\n![](https://raw.githubusercontent.com/Maxmudjon/images/master/Mijia-Smart-Socket-200x200.jpg)\n![](https://raw.githubusercontent.com/Maxmudjon/images/master/Mijia-Temperature-Humidity-Sensor-200x200.jpg)\n![](https://raw.githubusercontent.com/Maxmudjon/images/master/Mijia-Wireless-Switch-200x200.jpg)\n\nA new service has been added. Level battery.\n\n\u003ca href=\"url\"\u003e\u003cimg src=\"https://raw.githubusercontent.com/Maxmudjon/images/master/photo_2017-05-07_01-12-01.jpg\" align=\"left\" height=\"320\" width=\"180\" \u003e\u003c/a\u003e\n\u003ca href=\"url\"\u003e\u003cimg src=\"https://raw.githubusercontent.com/Maxmudjon/images/master/photo_2017-05-07_01-12-14.jpg\" align=\"center\" height=\"320\" width=\"180\" \u003e\u003c/a\u003e\n\u003ca href=\"url\"\u003e\u003cimg src=\"https://raw.githubusercontent.com/Maxmudjon/images/master/photo_2017-05-07_01-12-17.jpg\" align=\"right\" height=\"320\" width=\"180\" \u003e\u003c/a\u003e\n\n\nAdding a new low battery service. When the battery is low, the notification icon (iOS 10.3 or later version)\n\n\u003ca href=\"url\"\u003e\u003cimg src=\"https://raw.githubusercontent.com/Maxmudjon/images/master/photo_2017-05-06_01-15-25.jpg\" align=\"left\" height=\"320\" width=\"180\" \u003e\u003c/a\u003e\n\u003ca href=\"url\"\u003e\u003cimg src=\"https://raw.githubusercontent.com/Maxmudjon/images/master/photo_2017-05-06_01-15-39.jpg\" align=\"center\" height=\"320\" width=\"180\" \u003e\u003c/a\u003e\n\n\n### Pre-Requirements\n1. Make sure you have V2 of the gateway. V1 has limited space so can't support this feature.\n2. Update gateway firmware to 1.4.1_141.0141 or later. You can contact [@babymoney666](https://github.com/babymoney666) if your firmware is not up to date.\n\n### Installation\n1. Install HomeBridge, please follow it's [README](https://github.com/nfarina/homebridge/blob/master/README.md). If you are using Raspberry Pi, please read [Running-HomeBridge-on-a-Raspberry-Pi](https://github.com/nfarina/homebridge/wiki/Running-HomeBridge-on-a-Raspberry-Pi).\n2. Make sure you can see HomeBridge in your iOS devices, if not, please go back to step 1.\n3. Download homebridge-mijia to your local folder.\n\n### Configuration\n1. Open MiJia gateway's settings, enable [local network protocol](https://github.com/louisZL/lumi-gateway-local-api). Please follow the steps in this thread: http://bbs.xiaomi.cn/t-13198850. It's in Chinese so you might need a translator to read it.\n2. To control the devices, put gateway's MAC address (lower case without colon) and password to ~/.homebridge/config.json.\n\n\n        {\n            \"platforms\": [\n            {\n                \"platform\": \"MiJiaPlatform\",\n                \"sid\": [\"1a2b3c4d5e6f\"],\n                \"password\": [\"1234567890123456\"]\n            }]\n        }\n\n If you have more than one gateways, fill them in right order, like below.\n\n\n        {\n            \"platforms\": [\n            {\n                \"platform\": \"MiJiaPlatform\",\n                \"sid\": [\"1a2b3c4d5e6f\", \"1a2b3c4d5e6f\", \"1a2b3c4d5e6f\"],\n                \"password\": [\"1234567890123456\", \"1234567890123456\", \"1234567890123456\"]\n            }]\n        }\n\n If gateway's password is not set or not set right, you will see the following error in homebridge's output.\n\n\n        \u003e No password for gateway f0b429cbe4d3, please edit ~/.homebridge/config.json\n\n If you like to use Light Bulb type for Light Switch to make grandma Siri happy, like me, you can set the following in the config.\n\n\n        {\n            \"platforms\": [\n            {\n                \"platform\": \"MiJiaPlatform\",\n                ...\n                \"fakeLightBulbForLightSwitch\": true,\n                ...\n            }]\n        }\n        \n If you prefer to see sensor names instead of hex digis as name, add a mapping table to your config.json\n \n        {\n            \"platforms\": [\n            {\n                \"platform\": \"MiJiaPlatform\",\n                ...\n                \"sensor_names\": {\n\t\t\t\t\t\"0c08\":\"Kitchen Window\"\n                }\n                ...\n            }]\n        }   \n\n### Run it\n1. From source code\n\n\n        $ cd /path/to/homebridge-mijia\n        $ DEBUG=* homebridge -D -P .\n\n2. As homebridge plugin\n\n\n        $ npm install -g homebridge-mijia\n        $ homebridge\n","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fmaxmudjon%2Fhomebridge-mijia","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Fmaxmudjon%2Fhomebridge-mijia","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fmaxmudjon%2Fhomebridge-mijia/lists"}