Skip to main content
https://badge.fury.io/py/raincloudy.svg https://travis-ci.org/vanstinator/raincloudy.svg?branch=master https://coveralls.io/repos/github/vanstinator/raincloudy/badge.svg?branch=master

RainCloudy is a library written in Python 3.x that manages the Melnor RainCloud Smart Garden Watering Irrigation Timer.

Currently Melnor WifiAquaTimer not provide an official API. The results of this project are merely from reverse engineering. This project does not have any official relationship or support by Melnor.com. Use it at your own risk.

Melnor RainCloud official page: http://www.melnor.com/16043-raincloud-smart-water-timer

Source code documentation: http://raincloudy.readthedocs.io/

Usage

from raincloudy.core import RainCloudy
raincloudy = RainCloudy('username@domain', 'secret')

# list controllers linked with account
raincloudy.controllers
[<RainCloudyController: control_unit:abdcd1234 valve_unit:a123>]

# show valve unit battery status
raincloudy.controller.faucet_battery
99%

# show status
raincloudy.controller.status
'Online'

raincloudy.controller.name
'MelnorC001'

raincloudy.controller.faucet.name
'Backyard'

raincloudy.controller.faucet.status
'Online'

# 4 zones controlled per faucet
len(raincloudy.controller.faucet.zones)
4

# show details from zone1
raincloudy.controller.faucet.zone1
{
 'auto_watering': True,
 'manual_watering': False
 'next_cycle': 'Delayed',
 'rain_delay': 1,
 'watering_time': 0
 }

 # update attributes and show all zones
 raincloudy.controller.update()
 raincloudy.controller.faucet.zones
 {
    'zone1': {
        'auto_watering': True,
        'droplet': 'https://wifiaquatimer.com/static/images/blank.gif',
        'is_watering': False,
        'next_cycle': 'Delayed',
        'name': 'Backyard Flowers',
        'rain_delay': 1,
        'watering_time': 0
    },
    'zone2': {
        'auto_watering': True,
        'droplet': 'https://wifiaquatimer.com/static/images/blank.gif',
        'is_watering': False,
        'next_cycle': 'Delayed',
        'name': 'Tree Patio',
        'rain_delay': 2,
        'watering_time': 0
    },
    'zone3': {
        'auto_watering': True,
        'droplet': 'https://wifiaquatimer.com/static/images/blank.gif',
        'is_watering': False,
        'next_cycle': '3:17 AM',
        'name': 'Grass Backyard',
        'rain_delay': 0,
        'watering_time': 0
    },
    'zone4': {
        'auto_watering': True,
        'droplet': 'https://wifiaquatimer.com/static/images/blank.gif',
        'is_watering': False,
        'next_cycle': '4:00 AM',
        'name': 'Grass Front yard',
        'rain_delay': 0,
        'watering_time': 0
    }
}


# set faucet name
raincloudy.controller.faucet.name = 'Outside Left'
raincloudy.controller.faucet.name
'Outside Left'

# enable automatic program for zone1
raincloudy.controller.faucet.zone1.auto_watering = True

# run water for 15 minutes on zone3
raincloudy.controller.faucet.zone3.manual_watering = 15

# set rain delay for 2 days on zone2
raincloudy.controller.faucet.zone2.rain_delay = 2

Current Limitations

  • Only 1 (one) controller is supported.

  • Only 1 (one) valve unit is supported.

Metadata

Release files for raincloudy 1.2.0

For a detailed explanation of source distributions (sdists) and built distributions (wheels), please see the package formats documentation.

Source distribution (sdist)

Source distribution for raincloudy 1.2.0
File Size Uploaded Provenance
raincloudy-1.2.0.tar.gz 45.2 kB Without provenance Details

Built distribution (wheel)

Table of built distributions (wheels) for raincloudy 1.2.0
File Interpreter ABI Platform
raincloudy-1.2.0-py3-none-any.whl Python 3 none any Details

Total release size: 74.1 kB

Release files / raincloudy-1.2.0.tar.gz

Download URL raincloudy-1.2.0.tar.gz
Size 45.2 kB
Tags Source
SHA-256 checksum
How to use checksums
f43d590ef922ec9b8f2dcd2f4f1edb5cf0daee234ee915eb4abc87a88791eac3
BLAKE2b-256 checksum
How to use checksums
76be56986415d03b04c2fb9b8915419184d9a2b474266b7eb965f403de94ec26
Upload date
Uploaded using Trusted Publishing?
What is trusted publishing?
No
Uploaded via twine/4.0.0 CPython/3.9.13

Release files / raincloudy-1.2.0-py3-none-any.whl

Download URL raincloudy-1.2.0-py3-none-any.whl
Size 28.8 kB
Tags Python 3
SHA-256 checksum
How to use checksums
a507d688cecad678e4f1ad334b5bbf9cc4facfdf345807d71eb70e51f98dea5e
BLAKE2b-256 checksum
How to use checksums
a263fc607b51ba3e064b9446579206adc5470b51edffc25d26dea1f9204e4b1f
Upload date
Uploaded using Trusted Publishing?
What is trusted publishing?
No
Uploaded via twine/4.0.0 CPython/3.9.13

Security for raincloudy 1.2.0

Provenance

Provenance describes where a file came from. On PyPI, provenance is shared via attestations, which provide a verifiable record of the build or publishing details. View details, limitations and caveats.

No provenance found

None of the files in this release were uploaded with provenance metadata.

A note on package security

PyPI is a repository for distributing packages, not a service for auditing them. While third-party security researchers and our staff do their best to detect and remove malicious packages, PyPI cannot guarantee the quality, security or suitability of any given package.

Release history Release notifications | RSS feed

This release

1.2.0 This release

2 release files No provenance

Anthropic, PBC Visionary sponsor Bloomberg Visionary sponsor Hudson River Trading Visionary sponsor Meta Visionary sponsor NVIDIA Visionary sponsor Microsoft Sustainability sponsor Depot Continuous Integration AWS Cloud computing and Security Sponsor Datadog Monitoring Fastly CDN Google Download Analytics Sentry Error logging StatusPage Status page