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

Uploaded Source

Built Distribution

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

Uploaded Python 3

File details

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

File metadata

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

File hashes

Hashes for pysmartcocoon-1.2.3.tar.gz
Algorithm Hash digest
SHA256 00b53ee5a396c31c8d8a4dd9835e7a042f19e21c83468c61574691bcac383509
MD5 44456d468cd8aa87e9537e1132f1cd10
BLAKE2b-256 1e3d67a95fcbe6d7dc525b0d669480349cd0ed003e15d16747215950017b2c44

See more details on using hashes here.

File details

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

File metadata

File hashes

Hashes for pysmartcocoon-1.2.3-py3-none-any.whl
Algorithm Hash digest
SHA256 bee707006b8a6f86e575213b60bc4944c2dbba9ffd5071ca756c9e8ad7d7b27c
MD5 af15b26bfd835fcc95fce1913f069d3c
BLAKE2b-256 2d9a37b6766333112f836b02d5e841fe21411699fb0cd6c616c19d2638545d59

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