Home
A native Flutter (Android) client for a Breeze Core server — self-hosted control for Midea air conditioners, over your own LAN, with no cloud in the path.
Branding is deliberately generic: on first launch it asks for a server address and an access key, and reveals nothing about the backend.
Breeze is a client. Somebody has to run Breeze Core on your network — a Pi, a NAS, an old laptop is plenty. Its wiki covers that side.
Control, pairing and diagnostics work against any server version. Breeze Core ≥ 3.0.0 unlocks the full experience — Ed25519 request signing, live SSE updates, network scan-to-add, per-command beep — and older servers still work, falling back to bearer-token auth and manual add. The Programs screen needs the server's scheduler; the Nerd screen needs ≥ 3.0.5.
| If you want to… | Read |
|---|---|
| build and install it | Installing it |
| know what the main screen does | The control screen |
| control a unit without opening the app | Home-screen widgets · Android Auto |
| set up schedules and curves | Programs |
| work out why something misbehaves | Diagnostics and the Nerd screen |
| use more than one server | Multiple servers |
| know how credentials are held | Security |
| work on the app | Architecture · Building and releasing |
| see what each release changed | Version history |
| ask about iOS | iOS port (plan) |
- One unit per screen, swipe to switch. Each unit fills the screen, tinted to its active mode. No menus to dig through, no dashboard to configure.
- It reacts immediately. Every control is optimistic with haptic feedback, and the server pushes state over SSE — so the screen is right without waiting on a poll or a cloud round-trip.
- Control without opening it at all — home-screen widgets and an Android Auto screen that is one big power button.
- Schedules that do not need your phone. Favourites, schedules and temperature curves live on the server and fire with the phone off.
- Two permissions, total: internet and vibrate. No location, no contacts, no ads, no analytics, nothing to opt out of.
- It is quiet. Beep is off unless you turn it on.
- Material You, light/dark, °C/°F, and a real diagnostics screen.
The full comparison with the vendor app, including what you give up: Compared to NetHome Plus.
AGPL-3.0, the same as
the server. All dependencies are permissive (Flutter, http,
flutter_secure_storage BSD-3; dynamic_color Apache-2.0), which AGPL-3.0
permits.