golles/python-aquatlantis-ori
Asynchronous Python client for Aquatlantis Ori Smart Controller
Python Aquatlantis Ori
An asynchronous Python client for the Aquatlantis Ori Smart Controller
Caution
This project is a personal, unofficial effort and is not affiliated with Aquatlantis. It was created to learn and experiment with controlling my own aquarium.
The Ori API was reverse-engineered for this purpose, and functionality may break at any time if Aquatlantis changes their API.
I'm not responsible for any damage or issues that may arise from using this client. Use at your own risk!
Installation
You can install this package using your preferred package manager. For example, using pip:
pip install aquatlantis-oriUsage
To use the Aquatlantis Ori client, you can import it in your Python scripts and start interacting with your Ori controller. Here is a simple example:
import asyncio
import logging
from aquatlantis_ori import AquatlantisOriClient, LightOptions, PowerType
logging.basicConfig(level=logging.WARNING)
logging.getLogger("aquatlantis_ori").setLevel(logging.INFO)
async def main() -> None:
async with AquatlantisOriClient("email", "password") as client:
await client.connect()
device = client.get_devices()[0]
scenarios: list[dict] = [
{"power": PowerType.ON, "options": LightOptions(intensity=100, red=100, green=0, blue=0, white=0)},
{"power": PowerType.ON, "options": LightOptions(intensity=100, red=0, green=100, blue=0, white=0)},
{"power": PowerType.ON, "options": LightOptions(intensity=100, red=0, green=0, blue=100, white=0)},
{"power": PowerType.ON, "options": LightOptions(intensity=100, red=0, green=0, blue=0, white=100)},
{"power": PowerType.ON, "options": LightOptions(intensity=100, red=100, green=100, blue=100, white=100)},
{"power": PowerType.OFF},
{"power": PowerType.ON, "options": LightOptions(intensity=80, red=0, green=0, blue=0, white=100)},
{"power": PowerType.ON, "options": LightOptions(intensity=60, red=0, green=0, blue=0, white=100)},
{"power": PowerType.ON, "options": LightOptions(intensity=40, red=0, green=0, blue=0, white=100)},
{"power": PowerType.ON, "options": LightOptions(intensity=20, red=0, green=0, blue=0, white=100)},
{"power": PowerType.ON, "options": LightOptions(intensity=1, red=0, green=0, blue=0, white=100)},
{"power": PowerType.OFF},
]
for scenario in scenarios:
device.set_light(
power=scenario.get("power"),
options=scenario.get("options"),
)
await asyncio.sleep(2)
if __name__ == "__main__":
asyncio.run(main())Contributing
Contributions are welcome! Please familiarize yourself with the contribution guidelines. This document will also help you set up your development environment.
Thank you for your interest in the Python Aquatlantis Ori client! If you have any questions or need further assistance, feel free to open an issue or submit a pull request.