# Atomberg Console

> A macOS menu bar app for Atomberg fans, water purifiers and locks, made by Ashwin Gopalsamy. It controls fans over your Wi-Fi (UDP 5625 and 5600) and falls back to Atomberg's cloud API, spending at most one of the 100 daily calls per command. One cloud host, no dependencies, no analytics. Source-available under PolyForm Noncommercial 1.0.0.

Canonical: https://apps.ashwingopalsamy.in/atomberg-console/

## Start here
- [Install](https://apps.ashwingopalsamy.in/atomberg-console/install.md): Install with Homebrew, a DMG or from source, then paste your API key and refresh token once.
- [The 100-call budget](https://apps.ashwingopalsamy.in/atomberg-console/call-budget.md): A refresh costs one call, a command to a fan on your Wi-Fi costs none, a cloud command costs one, against 100 calls a day.
- [Why isn't my fan found locally?](https://apps.ashwingopalsamy.in/atomberg-console/local-control.md): The fan and your Mac are not on the same Wi-Fi, or macOS is blocking Local Network access for the app.
- [Privacy](https://apps.ashwingopalsamy.in/atomberg-console/privacy.md): Two destinations, no analytics, credentials only in your Keychain, and three commands to check it yourself.

## Reference
- [Developers and agents](https://apps.ashwingopalsamy.in/atomberg-console/developers.md): Read-only WebMCP and remote MCP tools for the docs, llms.txt, and the planned local MCP contract for the app.
- [Design](https://apps.ashwingopalsamy.in/atomberg-console/design.md): Principles, tokens, layout and status glyphs of the app.
- [Changelog](https://apps.ashwingopalsamy.in/atomberg-console/changelog.md): What changed in each release.