A native iPhone companion app for GaggiMate — the open-source espresso machine controller. GaggiApp replaces GaggiMate's web interface with a SwiftUI app that talks directly to your machine over your home Wi-Fi.
This is an independent, community-built app. It is not affiliated with or endorsed by the GaggiMate project.
- Brew — live dashboard (temperature, pressure, flow), mode switching, start/stop, and a live shot chart while pulling
- Profiles — list, select, favorite, and create/edit brew profiles
- Shots — shot history with a per-shot chart and notes (rating, dose, grind, taste)
- Machine — connection status, HomeKit and Siri Shortcuts support, ready notifications
- Light and dark themes, no accounts, no cloud, no paid Apple developer account required
- A GaggiMate controller on your espresso machine (built and tested against the GaggiMate Pro board, which has pressure/flow sensing and profiles; other boards should mostly work with those features hidden)
- iPhone running iOS 17 or later
- Your phone and machine on the same home Wi-Fi network
- Clone this repository and open
GaggiApp/GaggiApp.xcodeprojin Xcode (15 or later). - In the project's Signing & Capabilities tab, select your own Apple ID / team under Team — the checked-in signing team belongs to the original author and won't work for your build. A free personal Apple account is enough; no paid developer program needed.
- Build and run on a simulator (a Demo mode with mock data is available so you can explore the UI without a real machine) or on your device.
The app connects to the machine's WebSocket API at ws://gaggimate.local/ws (mDNS hostname,
configurable in-app) — the same API the GaggiMate web UI uses. There's no cloud service and no
account system; everything happens directly between your phone and your machine on your local
network.
Contributions are welcome — see CONTRIBUTING.md for how to get set up and what's most useful to work on.
GaggiApp is licensed under the GNU General Public License v3.0.