Ecosyste.ms: Awesome

An open API service indexing awesome lists of open source software.

Awesome Lists | Featured Topics | Projects

https://github.com/jfarmer08/ha-sengledapi

Home Assistant Integration for Sengled Bulbs. This is a custom component to allow control of Sengled Bulbs in Homeassistant using the unofficial Sengled API. Please note this mimics the Sengled app and therefore Sengled may cut off access at anytime.
https://github.com/jfarmer08/ha-sengledapi

hacs home-assistant home-automation homeassistant sengled sengled-bulbs wifi-bulbs

Last synced: 3 days ago
JSON representation

Host: GitHub
URL: https://github.com/jfarmer08/ha-sengledapi
Owner: jfarmer08
License: apache-2.0
Created: 2020-06-09T03:04:52.000Z (over 4 years ago)
Default Branch: master
Last Pushed: 2023-07-04T23:41:54.000Z (over 1 year ago)
Last Synced: 2024-12-11T08:51:36.804Z (11 days ago)
Topics: hacs, home-assistant, home-automation, homeassistant, sengled, sengled-bulbs, wifi-bulbs
Language: Python
Homepage:
Size: 156 KB
Stars: 107
Watchers: 7
Forks: 35
Open Issues: 10
Metadata Files:
- Readme: README.md
- License: LICENSE

Awesome Lists containing this project

README

# I no longer plan on supporting this integration with Home Assistant. If someone would like to take it over please contact me.

# Home Assistant - Sengled Bulb Integration

This is a custom component to allow control of Sengled Bulbs in Homeassistant using the unofficial Sengled API. Please note this mimics the Sengled app and therefore Sengled may cut off access at anytime.

# Supported Bulbs from Sengled
You can find [Supported Products](https://github.com/jfarmer08/ha-sengledapi/wiki) here. If you have other bulbs that are not on this list and they do work, you can create a pull request to have the wiki updated.

**The goal is to support all Sengled Bulbs so feel free to buy me coffee.

[![Donate](https://img.shields.io/badge/Donate-PayPal-blue.svg?style=flat-square&maxAge=2592000)](https://www.paypal.com/paypalme/AllenFarmer)

### Highlights of what **SengledApi** can do

* Control Sengled Bulbs as lights through HA
* Control Sengled Light Switch through HA

### Potential Downsides

* This is an unofficial implementation of the api and therefore may be disabled or broken at anytime by Sengled
* I only have Element Classic A19 Kit (Light bulbs + Hub) https://us.sengled.com/products/element-classic-kit and the Wifi LED Multicolor A19 Bulb https://us.sengled.com/products/sengled-smart-wi-fi-led-multicolor-a19-bulb to test.

* An update from Sengled may break this integration without my knowledge. **Please use the betas as they become avaliable**

** Wifi bulbs are supported by adding ```wifi: true``` to your configuration. All functions should be supported.

## Installation (HACS) - Highly Recommended

1. Have HACS installed, this will allow you to easily update
2. Add [https://github.com/jfarmer08/ha-sengledapi](https://github.com/jfarmer08/ha-sengledapi) as a custom repository as Type: Integration
3. Click install under "Sengled Bulb Integration" in the Integration tab
4. Restart HA

## Installation (Manual)
**Note: "requirements": ["paho-mqtt==1.5.0"]
1. Download this repository as a ZIP (green button, top right) and unzip the archive
2. Copy `/custom_components/sengledapi` to your `/` directory
* On Hassio the final location will be `/config/custom_components/sengledapi`
* On Hassbian the final location will be `/home/homeassistant/.homeassistant/custom_components/sengledapi`
3. Restart HA

## **SengledApi** NOTE: Configuration Changed Please update.
Country Code example:
* country: us
* country: au
* country: it
* country: eu

## Configuration

Add the following to your configuration file `configuration.yaml`. Update with your own information.

```yaml
sengledapi:
username: [email protected]
password: sengledPassword
country: us
wifi: true
```

## Usage

* Restart HA

* Entities will show up as `light.`, `switch.` for example (`light.livingroom_lamp`).

## Reporting an Issue

1. Setup your logger to print debug messages for this component by adding this to your `configuration.yaml`:
```yaml
logger:
default: warning
logs:
custom_components.sengledapi: debug
```
2. Restart HA
3. Verify you're still having the issue
4. File an issue in this Github Repository