fakoua / 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.

Geek Repo:Geek Repo

Github PK Tool:Github PK Tool

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 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.

Buy Me A Coffee

Highlights of what SengledApi can do

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

Potential Downsides

** 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 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 <config_dir>/ 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.

sengledapi:
  username: <email for sengled>
  password: <password for sengled>
  country: <country>
  wifi: true

Usage

  • Restart HA

  • Entities will show up as light.<friendly name>, switch.<friendly name> 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:
    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

About

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.

License:Apache License 2.0


Languages

Language:Python 100.0%