Skip to content

Mobile App ​

The Homecast app lets you control your Apple Home accessories from your phone, anywhere. It runs the same dashboard as homecast.cloud, so everything you can do in a browser you can do in the app — and improvements to the dashboard reach the app without an update.

Get the app ​

Platforms ​

  • iPhone and iPad: an iPhone or iPad invited to the home in Apple Home can also talk to Apple Home directly on its own behalf, so it keeps working when the relay can't be reached. See Local Mode.
  • Mac: the Mac app can also be the relay — the Mac that connects your whole household to Homecast, unless Homecast runs one for you on the Cloud plan. See Self-Hosted Setup.
  • Android, Windows and Linux: always reach your home through the relay. There is no Local Mode, so if the relay is offline these apps can't control anything until it's back.

Sign in ​

Homecast Cloud: use the same account as the web dashboard. Open the app, enter your email and password, and your homes appear.

Community Edition: choose Community instead. The app lists the Macs running Homecast on your network — pick yours and you're connected, with no address to type. If nothing appears (guest Wi-Fi and client-isolated networks block discovery), or you're away from home, enter the server URL instead. It accepts a full address, so a relay reached over a VPN or an HTTPS tunnel works the same way. See Community Setup.

What you get ​

The full dashboard: your homes, rooms, collections, scenes and automations, with the same widgets as the web. The app adds:

  • Push notifications from Notify actions in your automations (Homecast Cloud). Browsers don't receive push, so install the app on every phone that should get them, and allow notifications when asked.
  • Relay discovery — in the Community Edition, the app finds Macs running Homecast on your network.

Using it on a touchscreen ​

On a phone or tablet the dashboard works by touch rather than right-click:

  • Tap a tile to expand it — its actions (Analytics, Edit, Share, and more) are in the expanded panel
  • Long-press a tile, scene, sidebar row or automation to enter Edit Layout and pick it up in the same gesture; drag to rearrange, then tap Done Editing in the top-right ⋯ menu
  • The ⋯ menu in the top-right holds the actions for the home or room you're looking at — Share, Analytics, Background, Add Accessory, Automations, Create Scene, Edit Layout and Settings
  • Swipe in from the left edge to open the menu of homes and rooms
  • Pull down to refresh

There are no context menus on touch: a long press always means edit.

Troubleshooting ​

ProblemFix
App shows "No homes"Check that the relay is online — relay offline. On iPhone/iPad, Local Mode can serve the home without it.
Accessories not updatingPull down to refresh. Check relay status.
No push notificationsOn that phone, check Settings → Notifications (this device) and Settings → Homes → home → Notifications (per home and per automation). Allow notifications for Homecast in the phone's own settings.
Can't sign inSee login issues

Next: Account & Settings