/timeguard-supplymaster-python

This Python module will provides an open-source implementation of the client API used by the Timeguard's Supplymaster application

Primary LanguagePythonGNU General Public License v3.0GPL-3.0

timeguard-supplymaster-python

This Python module provides an open-source implementation of the client API used by Timeguard's Supplymaster application. This is typically used to control Timeguard's FSTWIFI Wi-Fi Controlled Fused Spur.

If you want to be able to control the device locally without Internet access take a look at the amazing work by Andrey Yantsen in this project: timeguard-mqtt.

This implementation is based on my investigation of the API.

It is currently in the early stages of development, contributions are always welcome but it will be a fast moving target.

Legal Disclaimer

This software is un-official and is not endorsed or associated with Timeguard Limited in any way, shape or form.

This information used has been gathered legally using the Supplymaster Android application and Charles Proxy.

This software is being developed to aid my own personal efforts to automate scheduling of my FSTWIFI device for Octopus Agile.

The software is provided “as is”, without warranty of any kind, express or implied, including but not limited to the warranties of merchantability, fitness for a particular purpose and noninfringement. in no event shall the authors or copyright holders be liable for any claim, damages or other liability, whether in an action of contract, tort or otherwise, arising from, out of or in connection with the softwares or the use or mis-used or other dealings in the software.

Setup

  1. Install the library:
pip install timeguard-supplymaster
  1. Create ~/.timeguard.yaml and add your login details:
---
username: your-username
password: your-password
use_cache: False
...

Usage

List all devices, programs and time slots:

from timeguard_supplymaster import Client

client = Client()
client.refresh_devices()

For more examples see the examples folder.

Contribute

Please do feel free to fork this module to enhance it for the benefit of everyone.