https://github.com/homebridge-plugins/homebridge-ewelink

Homebridge plugin to integrate eWeLink devices into HomeKit.
https://github.com/homebridge-plugins/homebridge-ewelink

eachen ewelink homebridge homebridge-ewelink homebridge-plugin homekit hoobs hoobs-plugin rf siri smartwise sonoff zigbee

Last synced: 12 days ago
JSON representation

Homebridge plugin to integrate eWeLink devices into HomeKit.

• Host: GitHub
• URL: https://github.com/homebridge-plugins/homebridge-ewelink
• Owner: homebridge-plugins
• License: mit
• Created: 2017-12-14T02:28:59.000Z (over 7 years ago)
• Default Branch: latest
• Last Pushed: 2025-04-01T01:34:17.000Z (25 days ago)
• Last Synced: 2025-04-06T22:02:27.338Z (20 days ago)
• Topics: eachen, ewelink, homebridge, homebridge-ewelink, homebridge-plugin, homekit, hoobs, hoobs-plugin, rf, siri, smartwise, sonoff, zigbee
• Language: JavaScript
• Homepage:
• Size: 3.81 MB
• Stars: 397
• Watchers: 26
• Forks: 127
• Open Issues: 88
• Metadata Files:
  • Readme: README.md
  • Changelog: CHANGELOG.md
  • Funding: .github/FUNDING.yml
  • License: LICENSE

Awesome Lists containing this project

README

        


   





# homebridge-ewelink

Homebridge plugin to integrate eWeLink devices into HomeKit

[![npm](https://img.shields.io/npm/v/homebridge-ewelink/latest?label=latest)](https://www.npmjs.com/package/homebridge-ewelink)

[![npm](https://img.shields.io/npm/v/homebridge-ewelink/beta?label=beta)](https://github.com/homebridge-plugins/homebridge-ewelink/wiki/Beta-Version)

[![verified-by-homebridge](https://badgen.net/badge/homebridge/verified/purple)](https://github.com/homebridge/homebridge/wiki/Verified-Plugins)

[![hoobs-certified](https://badgen.net/badge/HOOBS/certified/yellow?label=hoobs)](https://plugins.hoobs.org/plugin/homebridge-ewelink)

[![npm](https://img.shields.io/npm/dt/homebridge-ewelink)](https://www.npmjs.com/package/homebridge-ewelink)

[![Discord](https://img.shields.io/discord/432663330281226270?color=728ED5&logo=discord&label=hb-discord)](https://discord.com/channels/432663330281226270/742733745743855627)



### Plugin Information

- This plugin allows you to view and control your eWeLink devices within HomeKit. The plugin:

  - requires your eWeLink credentials to download a device list

  - attempts to control your supported devices locally, reverting to cloud control if necessary

  - listens for real-time device updates when controlled externally

  - supports removing your eWeLink credentials from the configuration in certain situations, see [wiki](https://github.com/homebridge-plugins/homebridge-ewelink/wiki/Connection-Methods#lan-mode-without-ewelink-credentials)

### Prerequisites

- To use this plugin, you will need to already have:

  - [Node](https://nodejs.org): latest version of `v18`, `v20` or `v22` - any other major version is not supported.

  - [Homebridge](https://homebridge.io): `v1.6` - refer to link for more information and installation instructions.

### Setup

- [Installation](https://github.com/homebridge-plugins/homebridge-ewelink/wiki/Installation)

- [Configuration](https://github.com/homebridge-plugins/homebridge-ewelink/wiki/Configuration)

- [Beta Version](https://github.com/homebridge/homebridge/wiki/How-to-Install-Alternate-Plugin-Versions)

- [Node Version](https://github.com/homebridge-plugins/homebridge-ewelink/wiki/Node-Version)

### Features

- [Supported Devices](https://github.com/homebridge-plugins/homebridge-ewelink/wiki/Supported-Devices)

- [Accessory Simulations](https://github.com/homebridge-plugins/homebridge-ewelink/wiki/Accessory-Simulations)

- [Connection Methods](https://github.com/homebridge-plugins/homebridge-ewelink/wiki/Connection-Methods)

- [Internal API](https://github.com/homebridge-plugins/homebridge-ewelink/wiki/Internal-API)

### Help/About

- [Common Errors](https://github.com/homebridge-plugins/homebridge-ewelink/wiki/Common-Errors)

- [Support Request](https://github.com/homebridge-plugins/homebridge-ewelink/issues/new/choose)

- [Changelog](https://github.com/homebridge-plugins/homebridge-ewelink/blob/latest/CHANGELOG.md)

- [About Me](https://github.com/sponsors/bwp91)

### Credits

- To the original plugin maintainer: [@gbro115](https://github.com/gbro115).

- To successive contributors: [@MrTomAsh](https://github.com/MrTomAsh) and [@howanghk](https://github.com/howanghk) for [homebridge-ewelink-max](https://github.com/howanghk/homebridge-ewelink).

- To the creators/contributors of [Homebridge](https://homebridge.io) who make this plugin possible.

- To the creators/contributors of [Fakegato](https://github.com/simont77/fakegato-history): [@simont77](https://github.com/simont77) and [@NorthernMan54](https://github.com/NorthernMan54).

- To the creator of the awesome plugin header logo: [Keryan Belahcene](https://www.instagram.com/keryan.me).

- To all users who have shared their devices to enable functionality.

### Disclaimer

- I am in no way affiliated with eWeLink nor any of the device brands (like Sonoff) and this plugin is a personal project that I maintain in my free time.

- Use this plugin entirely at your own risk - please see licence for more information.