sparkmike77/garmin

This repository holds two small projects for the Garmin Venu 2 smartwatch, both written in Monkey C, the programming language used for Garmin's Connect IQ apps. One is a watch face, and the other is a standalone app, and both let the watch talk to a Home Assistant smart home setup. The watch face shows a 24 hour clock along with heart rate, step count, stairs climbed, weather, a compass, battery level, the date, and a small indicator showing whether your Home Assistant server is currently reachable. The second project, the App, is a separate tool for actively controlling smart home devices from your wrist, such as opening a garage door or turning lights on and off. Since the Venu 2 has no wifi of its own, both projects communicate with Home Assistant's REST API by relaying through your phone's Bluetooth connection to the Garmin Connect Mobile app. Setting this up takes a few manual steps. You need Visual Studio Code with the Monkey C extension, the Connect IQ SDK with the Venu 2 device image installed, and Java 8 or newer. You also generate your own personal developer signing key, since Garmin requires every app to be signed and the repository does not include one. From Home Assistant, you create a long lived access token and note your instance's base URL, then for the App project specifically, you look up the entity IDs of the devices you want to control, like a garage door cover or a light. Each project ships a settings template file that you copy and fill in with your Home Assistant URL, token, and any entity IDs, keeping your personal credentials out of the shared code. Once configured, you build and run the project from VS Code, either in the simulator or by loading it onto a physical watch, including a documented workaround for copying files to the Venu 2 over USB on Windows, since the watch shows up as a media device rather than a normal drive. The README is explicit that developer keys and settings files should never be committed to the repository, and that any accidentally leaked token or key should be rotated immediately, since removing it from a later commit does not erase it from git history.