This is a fork of the original AlexxIT/SonoffLAN integration.
The purpose of this fork is to improve entity_id readability in Home Assistant by adding the device friendly name into the generated entity IDs.
This fork does not modify unique_id values. Existing installations remain unaffected. This fork replaces the original SonoffLAN integration and cannot be installed side-by-side.
The original SonoffLAN integration creates entity IDs using only the device ID:
switch.sonoff_1000xxxx_1
With many devices, this becomes difficult to manage.
This fork generates entity IDs that include the user-defined device name from the eWeLink/Sonoff app:
switch.sonoff_your_device_name_1000xxxx_1
- Friendly and readable clear entity IDs
- Multi-channel device support (
_1,_2,_3,_4) - Turkish character support (ı, İ, ğ, ş, ç, ö, ü)
- Works across all entity types:
- switch, sensor, light, cover, climate, remote, binary_sensor
- Backward compatible:
- Existing installations are not renamed automatically
- New installations and newly added devices use the new format
| Original Entity ID | New Entity ID |
|---|---|
switch.sonoff_1000xxxx_1 |
switch.sonoff_your_device_name_1000xxxx_1 |
sensor.sonoff_1000xxxx_power |
sensor.sonoff_your_device_name_1000xxxx_power |
light.sonoff_1000xxxx |
light.sonoff_your_device_name_1000xxxx |
cover.sonoff_1000xxxx |
cover.sonoff_your_device_name_1000xxxx |
- Open HACS → Integrations
- Click the menu (⋮) → Custom repositories
- Add this repository URL:
https://github.com/levonisyas/SonoffLAN-ClearIDS
- Select category: Integration
- Search for:
Sonoff LAN Clear IDs
- Install and restart Home Assistant
- Original Integration:
https://github.com/AlexxIT/SonoffLAN
All credits for the original integration belong to AlexxIT and contributors.
This fork only adds improved entity_id naming support.