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.1.0.tar.gz (11.3 kB view details)

Uploaded Source

Built Distribution

pysmartcocoon-1.1.0-py3-none-any.whl (12.3 kB view details)

Uploaded Python 3

File details

Details for the file pysmartcocoon-1.1.0.tar.gz.

File metadata

  • Download URL: pysmartcocoon-1.1.0.tar.gz
  • Upload date:
  • Size: 11.3 kB
  • Tags: Source
  • Uploaded using Trusted Publishing? No
  • Uploaded via: twine/5.0.0 CPython/3.11.4

File hashes

Hashes for pysmartcocoon-1.1.0.tar.gz
Algorithm Hash digest
SHA256 4df1ec2c2342d41aeb2cbb5798835114100361ba801d60cd73bd85c60226e584
MD5 61fdfa118c5345dd40bfb4e653c3552e
BLAKE2b-256 de817afea95bd1583e700cf10b9b97f05cde86e61deb56b1f9ae6b9f6e1e5c38

See more details on using hashes here.

File details

Details for the file pysmartcocoon-1.1.0-py3-none-any.whl.

File metadata

File hashes

Hashes for pysmartcocoon-1.1.0-py3-none-any.whl
Algorithm Hash digest
SHA256 37e5365b7aecb170b6ed122eeebf500e0f296c9fe5523fd5c1ede2838287e53a
MD5 a16ba9cafa60b874b6b7abda1462a677
BLAKE2b-256 58484e4c95fd00dfe6e910606ff93a00231d68176d57e939fe5b2a6725226d6e

See more details on using hashes here.

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