Skip to main content

Simple python wrapper over wirelesstags REST API

Project description

# WirelessSensorTags [![Build Status](]( [![Coverage Status](]( ![PyPI - Python Version](

A simple python wrapper library for Wireless Sensor Tag platform (

Supports getting data for registered by end user sensor tags. account credentials are needed to use this lib.
Enabling tags sharing is not required.

Verified with:
- 13-bit motion/temperature/humidity tags (type 13)
- Water/Moisture tags (type 32)
- ALS Pro tag (type 26)

# Installation

pip3 install wirelesstagpy

# Development notes
See for API details.

# Usage

# Fetch all tags


import wirelesstagpy

api = wirelesstagpy.WirelessTags(username='login_email', password='your_password')
sensors = api.load_tags()
for (uuid, tag) in sensors.items():
print('Loaded sensor: {}, temp: {}, humidity: {} probe taken: {}'.format(, tag.temperature,
tag.humidity, tag.time_since_last_update))


# Install custom push notifications

Wireless Sensor Tags platforms allows to setup custom url calls for set of specific events.

import wirelesstagpy

api = wirelesstagpy.WirelessTags(username='login_email', password='your_password')
notifications = [
NotificationConfig('update', {
'url': 'http://some_local_ip/update_tags',
'verb': 'POST'
'disabled': False,
'nat': True

# install notification for tag with id=1 only
succeed = api.install_push_notification(1, notifications, False)


# Arm/Disarm sensor monitoring for specific event

Supported events include: motion, temperature, humidity, light

import wirelesstagpy

api = wirelesstagpy.WirelessTags(username='login_email', password='your_password')

# arm humidity monitoring for tag with id 1,
# returned instance is updated SensorTag
sensor = api.arm_humidity(1)

# Disarm it
sensor = api.disarm_humidity(1)


# Disclaimer
"Wireless Sensor Tags", "KumoSensor" and "Kumostat" are trademarks of Cao Gadgets LLC,
see for more information.

I am in no way affiliated with Cao Gadgets LLC.

# Copyright

# Changelog

3/11/2018 Initial commit
3/19/2018 Added support for arm/disarm logic for motion/temp/humidity/light

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

wirelesstagpy-0.3.0.tar.gz (9.4 kB view hashes)

Uploaded source

Built Distribution

wirelesstagpy-0.3.0-py3-none-any.whl (11.5 kB view hashes)

Uploaded py3

Supported by

AWS AWS Cloud computing Datadog Datadog Monitoring Facebook / Instagram Facebook / Instagram PSF Sponsor Fastly Fastly CDN Google Google Object Storage and Download Analytics Huawei Huawei PSF Sponsor Microsoft Microsoft PSF Sponsor NVIDIA NVIDIA PSF Sponsor Pingdom Pingdom Monitoring Salesforce Salesforce PSF Sponsor Sentry Sentry Error logging StatusPage StatusPage Status page