Breeze

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.

It needs a server

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.

Where to go

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
try it on an iPhone (untested)	iOS

What it gives you

• 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.

Licence

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.