Skip to content

Notify ​

Category: Action

Sends a push notification to your devices when an automation runs.

Push is Homecast Cloud only. In the Community Edition, Notify shows a banner on the relay Mac and nothing else.

When to use ​

  • Alert when a door is opened while you're away
  • Notify when temperature exceeds a safe range
  • Confirm that an automation completed successfully
  • Send a summary of daily device activity

Configuration ​

  • Message — The notification body text. Supports template expressions:
    • {{ trigger.to_value }} — include the value that triggered the automation
    • {{ nodes.http1.data.body.weather }} — include data from upstream nodes
  • Title (optional) — The notification title/heading
  • Icon (optional) — The picture on the notification, so you can tell at a glance which automation spoke. Three choices:
    • None — no icon
    • Predefined — pick a glyph from the grid (leak, door, alert, battery…) and one of 8 tile colours. Colour is worth using deliberately: red for alerts, amber for warnings, green for confirmations
    • Custom — an https URL, which supports template expressions, e.g. {{ nodes.snapshot.data.url }} to show the camera frame from an upstream HTTP node. Custom images aren't recoloured

Delivery ​

  • Push — native macOS/iOS (via APNs) and Android (via FCM) Homecast apps
  • Relay alert — macOS notification banner on the relay Mac; if the relay is offline from the cloud, it still banners locally

Each device controls its own notifications, on that device: a master toggle in Settings > Notifications, and a toggle per home and per automation that sends notifications in Settings > Homes > [home] > Notifications. Turning something off mutes it for that device only — other devices and home members are unaffected, and the automation keeps running.

Push goes to you and to home members who have accepted their invitation, on every device where they've installed the Homecast app and allowed notifications. Browsers don't receive push, and there is no email channel.

How the icon appears per channel ​

  • Relay alert (macOS) — a thumbnail beside the banner. Built-in icons are drawn on the Mac itself, so they show instantly and work with no internet.
  • iPhone / Mac push — a thumbnail beside the banner.

The Homecast icon stays

Your icon appears alongside the Homecast app icon, not instead of it. Apple draws the app icon itself and gives no way to replace or hide it on a notification — the icon you choose occupies the trailing thumbnail slot. This is why colour is useful: it's what makes one notification distinguishable from another at a glance.

  • Android — the expanded notification's large picture. This is the only image hook Android exposes to a URL; the small status-bar icon is always the Homecast icon. A photo (like a camera snapshot) suits this better than a glyph.

An icon is decoration, never a gate: if a custom URL is unreachable, slow, or isn't an image, the notification is still delivered — just without it.

Rate limits ​

  • 30 push/hour per automation
  • 200 push/day per user

Output data ​

  • {{ nodes['<id>'].data.message }} — The resolved message that was sent
  • {{ nodes['<id>'].data.title }} — The resolved title
  • {{ nodes['<id>'].data.icon }} — The resolved icon (slug or URL)
  • {{ nodes['<id>'].data.success }} — true if the action ran without error
  • {{ nodes['<id>'].data.delivered }} — true if something actually reached a device
  • {{ nodes['<id>'].data.channels }} — Which channels sent, e.g. ['push'] or ['local']
  • {{ nodes['<id>'].data.rateLimited }} — true if a rate limit suppressed the send
  • {{ nodes['<id>'].data.reason }} — Why nothing was delivered: rate_limited, no_devices, muted, error

success and delivered are different facts: a rate-limited notification is a successful action that reached nobody.

Examples ​

Temperature alert with value:

  1. Device Changed → thermostat, temperature above 30
  2. Notify → title "Temperature Alert", message "Living room is {{ trigger.to_value }}°C"

Door opened notification:

  1. Device Changed → front door sensor, contact_state to 1
  2. Notify → icon "Door open", message "Front door was opened at {{ now().hour }}:{{ now().minute }}"

Camera snapshot on motion:

  1. Device Changed → motion sensor
  2. HTTP Request → fetch a snapshot URL from your camera
  3. Notify → icon {{ nodes.http1.data.body.url }}, message "Motion at the front door"

Tips ​

  • Template expressions in the message and the icon URL are resolved at send time — use them to include dynamic values
  • Give related automations the same icon and different ones to unrelated alerts; the icon is what makes a notification recognisable before you read it
  • Custom icon URLs must be https and publicly reachable — the notification is fetched by your phone or Mac, not by the Homecast server, so a URL that only resolves on your LAN won't load on mobile data
  • Install the Homecast app on each device that should receive push, and check Settings > Notifications on that device
  • For critical alerts, consider also setting a device (e.g. flashing a light) as a backup