pyAlfawise

a simple python3 library for the Alfawise Humidifier


Keywords
alfawise, humidifier, mist, API
License
MIT
Install
pip install pyAlfawise==0.7-beta

Documentation

PyAlfawise

Build Status GitHub release PyPI version pyAlfawise GitHub Donate

AlfaWise Humidificateur

Library

PyAlfawise 💡 is a simple python3 library for the Alfawise Humidifier.

  • This library is under development but still usable
  • This library has been developed above the work of sarakha63
  • The tests are only made with my own model which is the one on the picture above. If you have any other model that can match with this library please feel free to PR.
  • There is no official API for now, so this library can be broken at any time.

TODO

  • Add test coverage
  • Add the library to Pypi
  • Correct some bugs (see TODO in code)
  • Add possibility to ask the device back for its current state (reverse engineering needed)
  • Still some bug to fix with reading device state as the answer does not reflect the real state (bug ?)
  • .... and lots of things !

How-To

  1. You have to setup your device with the AMA app to connect it to your local wifi network.
  2. Determine your bulb ip and mac address (using router, software, ping and so on)
  3. Open your favorite python3 console
>>> import pyAlfawise
>>> device = pyAlfawise.Alfawise("mac address", "ip address")
>>> device.turn_on()

What can I add ?

  • PR are welcome
  • Advices on library structure are welcome too, this is one of my first python library and I'm still a noob on Python code
  • If you want to contact me : @hydreliox on Twitter

forthebadge made-with-python