Skip to content

Sharing Access ​

Homecast supports two ways to share: home members (invite someone to your entire home) and share links (share specific accessories, rooms, or collections via URL).

Invite a home member ​

Home members are a Homecast Cloud feature; the Community Edition has no member invites.

How to invite ​

  1. Open the home's Share dialog:
    • With a mouse: right-click the home in the sidebar → Share Home
    • On touch: select the home, tap the top-right ⋯ menu → Share
  2. In the Members section, click + to open Add Member
  3. Enter their email address and choose a role (Control is preselected):

Home members

RoleSee accessoriesControl accessories and run scenesCreate and edit scenes and Apple Home automationsManage membersManage share links
AdminYesYesYesYesYes
ControlYesYesYesNoNo
ViewYesNoNoNoNo
  1. Click Invite — they receive an email with the home's name and their role

Only the owner and admins see the Members section. Members don't need a paid plan of their own; they see the accessories the owner's plan includes.

What the invited person sees ​

  • If they already have a Homecast account, a Home Invitations dialog appears when they next sign in, with Accept and Decline
  • If they don't have an account yet, the invitation waits — once they sign up with the same email address and verify it, the invitation is offered
  • Until then, their row in Members shows Awaiting sign-up or Awaiting acceptance
  • Once accepted, the home appears in their sidebar and under Settings → Homes → Homes shared with you

Change a member's role ​

Open the home's Share dialog and pick a new role from the dropdown next to their name.

Remove a member ​

Open the home's Share dialog and click the trash icon next to their name. Their access is revoked immediately. Members can't remove themselves — ask an owner or admin.

Relay access in Apple Home ​

Separate from Homecast's own roles above, the relay's Apple ID has its own permission level inside Apple Home:

LevelWhat worksHomeKit automations
View-only (default for invited members)Accessory control, scenes, monitoring, APIs, AI assistants, Homecast automationsRead-only — view and inspect, but not create or change
Add & Edit Accessories ("Allow Editing" on older iOS)Everything aboveFull — Homecast and AI assistants can create, edit, enable/disable, and delete

Both levels are fully supported — choose based on how much you want Homecast to manage. The current level is shown under Settings → your home → Apple Home access, and can be changed anytime in the Apple Home app: Home Settings → tap the relay user → toggle "Add & Edit Accessories".

A share link gives someone access to one thing — an accessory, a group, a room, a collection, or the whole home — without a Homecast account. Good for guests, a babysitter, or a cleaner.

Permissions

Only home owners and admins can create and manage share links. Control and View members see the dialog but can't change it.

  1. Open the Share dialog for what you want to share:
    • With a mouse: right-click it in the sidebar → Share Home, Share Room, or Share Group; for an accessory, right-click its tile → Share
    • On touch: select the home or room and tap the top-right ⋯ menu → Share; for an accessory, tap the tile to expand it → Share
  2. Each item has one link, shown at the top with Copy, Open, and a QR code. Decide who it works for:

Share dialog

SettingOptions
Public AccessOff (nobody without a passcode), View (anyone with the link can see), or Control (anyone with the link can control)
PasscodesClick + → Add Passcode: an optional name, the passcode, an access level (View or Control), and an optional schedule

You can combine them — for example, public View for everyone with the link, and a Control passcode that unlocks control for the people who know it. When public access is already Control, passcodes aren't needed.

Limit when a passcode works ​

Turn on Limited Access in Add Passcode to restrict when that passcode can be used:

  • Start Date and Expiration Date (both optional) — e.g. a guest's arrival and departure
  • Time Windows — Add Window, pick days (or Weekdays / Weekends), and a From / Until time in half-hour steps, in the timezone you choose

The schedule is checked on every request, so an expired passcode stops working at once. Two limits to plan around:

  • A window can't cross midnight — for 10 pm to 6 am, add two windows (10 pm–11:30 pm and 12 am–6 am)
  • The latest Until time is 11:30 pm, so a window ends at 11:30 pm rather than midnight

Outside its schedule, a passcode is refused with the same Access Denied message as a wrong passcode — tell your guest when it will work.

Public access has no schedule; to time-box access, use a passcode.

What the recipient sees ​

A standalone page showing only what you shared, with a View Only or Control Access badge. No app or account is needed. A passcode-protected link asks for the code first; a link with public View and a Control passcode offers Unlock Control.

If the owner has turned on Analytics on shared links, the page can also show charts for what it shares.

Share links also work as API endpoints. GET https://api.homecast.cloud/s/{hash} returns the current state as JSON — useful for scripts and dashboards. See Share Links reference.

Revoke access ​

  • Public access: set Public Access to Off
  • A passcode: click the trash icon on its row
  • Everything you've shared: Settings → Sharing → Shared Items

Removing a passcode doesn't change the link — public access and other passcodes on it keep working. The link itself stays the same for as long as the item is shared.

For developers

Access tokens and OAuth clients can also be scoped to specific homes with view or control permissions. See Authentication and the Share Links API reference.


Something not working? Sharing issues