Skip to main content

Library built for Home Assistant to integrate with the SmartCocoon

Project description

SmartCocoon Python API

GitHub Release GitHub Activity License

pre-commit Black

Project Maintenance BuyMeCoffee

logo

This Python library allows you to control SmartCocoon fans.

Status

This is not an official API from SmartCocoon and is in the the very early stages of developement.

This API is built for the main purpose of integrating into Home Assistant but can be used independently.

Supported devices

  • SmartCocoon Smart Vents

Features

The following feature are supported:

  • Connect to the SmartCocoon cloud service
  • Obtain configuration data as it has been set up through the SmartCocoon mobile app
  • Ability to control fans
    • Turn on/off
    • Set speed
    • Set Auto mode
    • Set Eco mode

Examples

You can refer to the tests/test_integration.py to see an example of integration with the SmartCocoon API

Copy the tests/template.env* to _tests/.env* file and update the account information with your your SmartCocoon account information:

USERNAME="user@domain.com"
PASSWORD="mypassword"
FAN_ID="abc123"

Work to do

  • The fans are using MQTT but this is not being leveraged yet
  • Discovery has not been implemented, not sure if this is possible
  • Fan status will currently require polling if the fan is changed directly in the app

Project details


Download files

Download the file for your platform. If you're not sure which to choose, learn more about installing packages.

Source Distribution

pysmartcocoon-1.0.0.tar.gz (12.5 kB view hashes)

Uploaded Source

Built Distribution

pysmartcocoon-1.0.0-py3-none-any.whl (13.5 kB view hashes)

Uploaded Python 3

Supported by

AWS AWS Cloud computing and Security Sponsor Datadog Datadog Monitoring Fastly Fastly CDN Google Google Download Analytics Microsoft Microsoft PSF Sponsor Pingdom Pingdom Monitoring Sentry Sentry Error logging StatusPage StatusPage Status page