Skip to content

Your home as a live 3D model in the Mac menu bar and on iPhone — lights and ACs via Smart Life, Home Assistant, Philips Hue and Apple Home.

Changelog for 1.0.0, and release notes taken from it

0xProbability032a80db2d6b
diff --git a/.github/workflows/release.yml b/.github/workflows/release.yml
index ef059ad..33a07a2 100644
--- a/.github/workflows/release.yml
+++ b/.github/workflows/release.yml
@@ -83,6 +83,15 @@ jobs:
GH_TOKEN: ${{ github.token }}
VERSION: ${{ steps.version.outputs.version }}
run: |
+ # The notes are this version's section of CHANGELOG.md, or GitHub's list of commits without one.
+ awk -v v="$VERSION" '$0 ~ "^## " { if (on) exit; on = index($0, "## " v " ") == 1; next } on' CHANGELOG.md > build/notes.md
+ if [ -s build/notes.md ]; then
+ printf '\n**Full changelog:** [CHANGELOG.md](%s/%s/blob/%s/CHANGELOG.md)\n' \
+ "$GITHUB_SERVER_URL" "$GITHUB_REPOSITORY" "$GITHUB_REF_NAME" >> build/notes.md
+ notes=(--notes-file build/notes.md)
+ else
+ notes=(--generate-notes)
+ fi
gh release create "$GITHUB_REF_NAME" --draft --verify-tag \
- --title "House Control $VERSION" --generate-notes \
+ --title "House Control $VERSION" "${notes[@]}" \
"build/HouseControl-$VERSION.dmg" "build/HouseControl-$VERSION.dmg.sha256"
diff --git a/CHANGELOG.md b/CHANGELOG.md
new file mode 100644
index 0000000..0991d04
--- /dev/null
+++ b/CHANGELOG.md
@@ -0,0 +1,58 @@
+# Changelog
+
+What changed in each release of House Control. The Mac app is on
+[Releases](https://github.com/0xProbabillity/house-control/releases); the iPhone app is on TestFlight.
+
+## 1.0.0 — 2026-10-15
+
+### Widgets, controls and quick actions
+
+- **Widgets** for the iPhone's Home Screen, Lock Screen and StandBy, and for the Mac's desktop: Home in 3D,
+ Scenes, Light, Room, Climate and Home Status.
+- **Control Center controls** on the iPhone: All Lights, a Light, a Scene and an Air Conditioner.
+- **Quick actions** on the iPhone's app icon, chosen in Settings.
+- Every widget is live: tap a lamp, a scene or an AC and it switches without opening the app. On the Mac the app in
+ the menu bar carries it out; on the iPhone the widget talks to Home Assistant, Hue and Smart Life itself.
+ See [docs/widgets.md](docs/widgets.md).
+
+### An iPhone app that needs no Mac
+
+- **Floor plan editor on the phone:** the Mac's editor laid out for a finger — tap to select, drag what is selected,
+ pan, pinch to zoom, details in a sheet from the bottom. **New home** starts from one room or a demo layout.
+- **Home Assistant and Philips Hue** screens on the phone; servers and bridges on the Wi-Fi are found by themselves.
+- **Devices:** link each lamp and AC to a real device from one searchable list, or add several devices to a room
+ already linked.
+- **Smart Life on a single phone:** save the sign-in code to Photos and scan it from the Smart Life app.
+- **Sync both ways.** A paired Mac is optional. Plans edited on either side reach the other, and so do Home Assistant
+ and Hue connections (the newest wins, a disconnect included). If both changed the plan while apart, the phone
+ asks which one to keep.
+
+### Two iPhone editions
+
+- **App Store edition:** Home Assistant, Philips Hue and Apple Home.
+- **Smart Life edition:** all of that plus Smart Life / Tuya, for TestFlight and your own phone.
+- Smart Life now lives in its own module (`HouseSmartLife`), linked only by the Mac app and the Smart Life
+ edition. The two editions are separate apps and can sit on one phone.
+
+### Also
+
+- **About** links (website, privacy policy, support, source) on the iPhone and in the Mac's menu.
+- The editor only offers the platforms the app has.
+- A privacy manifest for the widgets.
+- From this release on, every Mac disk image carries a build provenance attestation:
+ `gh attestation verify HouseControl-1.0.0.dmg --repo 0xProbabillity/house-control`
+ ([#5](https://github.com/0xProbabillity/house-control/issues/5)).
+
+### Fixed
+
+- The iPhone never found Hue Bridges or Home Assistant servers on the network: iOS only browses the Bonjour types an
+ app declares, and those two were missing.
+- Widgets could jump back to an older state when the app started with widget taps still queued.
+
+## 0.1.0 — 2026-10-14
+
+The first public release: the home as a live 3D model in the Mac menu bar and on the iPhone, the island under the
+notch, the floor plan editor, AI Access, and Smart Life, Home Assistant, Philips Hue and Apple Home.
+
+This image was built while the repository was still private, so it has no build provenance attestation — only its
+SHA-256 can be checked.
diff --git a/README.md b/README.md
index 463dc24..0bfdf12 100644
--- a/README.md
+++ b/README.md
@@ -61,6 +61,8 @@ No frameworks, no Electron, no server, no account of its own.
- Or, in Terminal: `xattr -dr com.apple.quarantine "/Applications/House Control.app"`
4. Look for the house in the menu bar — there is no Dock icon and no window. Click it.
+What is new in each release: [CHANGELOG.md](CHANGELOG.md).
+
It starts with a bundled demo plan, so you can try everything before connecting anything. Then:
[make it your home](#make-it-your-home) and [connect real devices](#connect-real-devices).
To start it with your Mac, add it under **System Settings → General → Login Items**.
@@ -76,6 +78,8 @@ gh attestation verify HouseControl-<version>.dmg --repo 0xProbabillity/house-con
```
The second command proves the image was built by this repository's workflow, and shows from which commit.
+Images from 1.0.0 on carry an attestation; 0.1.0 was built while the repository was still private, when GitHub
+does not store attestations for free accounts, so for it only the SHA-256 can be checked.
### Why the app is not notarized
@@ -415,10 +419,11 @@ The binary has a few offline self-checks and one read-only diagnostic:
### Releasing the Mac app
-Set `MARKETING_VERSION` in `ios/Config/Base.xcconfig`, commit, then tag and push:
+Set `MARKETING_VERSION` in `ios/Config/Base.xcconfig`, add a `## <version> — <date>` section to
+[CHANGELOG.md](CHANGELOG.md) (it becomes the release notes), commit, then tag and push:
```bash
-git tag v0.1.0 && git push origin v0.1.0
+git tag v1.0.0 && git push origin v1.0.0
```
[`release.yml`](.github/workflows/release.yml) builds the universal app on a GitHub macOS runner
@@ -431,8 +436,8 @@ signed and notarized image locally instead; the script lists what it needs.
## Limitations
-- The iPhone app is not on the App Store (it is on TestFlight for the author's testers).
-- The floor plan is edited on the Mac only. The iPhone receives it, and only while both are on the same network.
+- The iPhone app is not on the App Store yet (it is on TestFlight for the author's testers).
+- The Mac and the iPhone sync only while both are on the same network; there is no cloud in between.
- Rooms are axis-aligned rectangles. An L-shaped room is two rooms.
- Apple Home devices are switched by the iPhone app only: macOS gives HomeKit to App Store apps only.
- Smart Life devices are reached through Tuya's cloud, not over the local network, so they need an internet