nicesprinkler
Your lawn does not need a robot. It needs water in the right place.
Two stepper motors, a garden hose and a Raspberry Pi. One motor turns, the other lifts, and the jet lands where the software says it should — if the software knows the truth about the garden. Getting it to know that is the interesting part.
What it does
- Simulates the throw over a 3D model of your garden before a drop falls
- Aims the head from the browser, or from a pattern
- Watches itself through the device camera while it works
- Measures its own flow with a bucket and a stopwatch, and remembers it
Why the camera
A stepper says where it was told to go. Water pressure has opinions. The hose bends, the head shifts under the jet, and the model drifts away from the machine. So every frame the camera records is written with the commanded angles beside it — pictures without angles teach nothing.
Install
pip install nicesprinkler
Run
sprinkler -s
Then open the address it prints. On a Raspberry Pi it drives the motors through TB6600 drivers; anywhere else it runs the simulation with a mock GPIO, so you can build the garden model on your laptop.
Configure
Lawn size, head position, angle limits, hose specification and motor pins
live in one yaml. Start from nicesprinkler_examples/example_config.yaml.
Documentation
License
Apache 2.0
1 maintainer
Metadata
1 maintainer
Release files for nicesprinkler 0.0.3
For a detailed explanation of source distributions (sdists) and built distributions (wheels), please see the package formats documentation.
Source distribution (sdist)
| File | Size | Uploaded | |
|---|---|---|---|
| nicesprinkler-0.0.3.tar.gz | 4.9 MB | Details |
Built distribution (wheel)
| File | Interpreter | ABI | Platform | Reset |
|---|---|---|---|---|
| nicesprinkler-0.0.3-py3-none-any.whl | Python 3 | none | any | Details |
Total release size: 5.1 MB
Release files / nicesprinkler-0.0.3.tar.gz
| Download URL | nicesprinkler-0.0.3.tar.gz |
|---|---|
| Size | 4.9 MB |
| Tags | Source |
|
SHA-256 checksum How to use checksums |
6dea4ea2876483d60f2656ca37f6b6cc9d6323ea25788a9d87885a247d51eea1
|
|
BLAKE2b-256 checksum How to use checksums |
498987ed86dc6cec8aa1da31e7ce707299979f70e417c453e4075604cec65657
|
| Upload date | |
|
Uploaded using Trusted Publishing? What is trusted publishing? |
Yes |
| Uploaded via |
twine/7.0.0 CPython/3.13.14
|
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.
PyPI Publish Attestation
PyPI verified that this artifact, at this checksum, originated from the publisher listed below.
Signed by GitHub Actions, verified by PyPI on Aug 15, 2026.
Transparency logRelease files / nicesprinkler-0.0.3-py3-none-any.whl
| Download URL | nicesprinkler-0.0.3-py3-none-any.whl |
|---|---|
| Size | 175.7 kB |
| Tags | Python 3 |
|
SHA-256 checksum How to use checksums |
1bc137da4b2574368f89b846a7f9f49d278db03afb7ab900f4de5848a5a1ec02
|
|
BLAKE2b-256 checksum How to use checksums |
38240a816564e3ad8eb0191cb5e377fdfd19af96211a50ac50b0faa927e5dc7b
|
| Upload date | |
|
Uploaded using Trusted Publishing? What is trusted publishing? |
Yes |
| Uploaded via |
twine/7.0.0 CPython/3.13.14
|
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.
PyPI Publish Attestation
PyPI verified that this artifact, at this checksum, originated from the publisher listed below.
Signed by GitHub Actions, verified by PyPI on Aug 15, 2026.
Transparency log
