Foyer support

Get help or report a problem by email at support@kilotonlabs.com or through GitHub Issues. Issues are public: never post pairing codes, access tokens, passwords, server addresses, household device names, camera pictures, or unredacted screenshots and logs. Report a security problem privately through a private security advisory.

When reporting a problem, include the Foyer version (Settings > About and privacy on the TV), your Roku model and OS version, your Home Assistant version and installation type, what you did, and what you expected and saw. Say whether it also happens in the demo.

Connecting

1. Install the Foyer integration in Home Assistant and restart Home Assistant.
2. Open Foyer on the TV. Home Assistant finds it on your network: under Settings > Devices & services, Foyer shows the TV as discovered. Select Add, then choose the rooms, cameras, favorites and scenes it may show.
3. The TV and Home Assistant show the same number. Check that they match, then choose Connect on the TV.

If the TV is not discovered, add Foyer in Settings > Devices & services yourself, choose what it shows, and write down the eight-digit pairing code. On the TV, choose Enter address instead, enter your server address, such as http://homeassistant.local:8123, without a dashboard path, and enter all eight digits within ten minutes.

HTTPS needs a certificate your Roku trusts. HTTP is unencrypted; use it only on a trusted home network. Use your server's final address, not one that redirects or asks for a separate login.

Cameras

The camera grid shows pictures that refresh about once a second. Opening a camera shows its picture at once and switches to live video when the stream starts, which can take several seconds. Live video needs a camera that Home Assistant can stream; other cameras keep showing refreshed pictures.

Doorbell alerts and notifications

Use the foyer.show_camera action in an automation to bring the TV to a camera, with up to three buttons for devices such as the porch light or the front door lock. The alert returns to what was playing after the time you set. foyer.notify shows a message in the corner of the screen while Foyer is open.

To let an alert or cast open Foyer while you use another app, allow network control on the Roku: Settings > System > Advanced system settings > Control by mobile apps > Network access.

Controls

Only the rooms and devices you selected can be seen or controlled from the TV. Unlocking doors and opening garage doors or gates are off unless you allow them in Foyer's settings, and then need OK held for a second on the TV. Unknown or unavailable is shown as Not reporting, never as an all-clear.

Casting

Each paired TV appears in Home Assistant as a media player. Cast from the media browser, an automation or a script. Supported formats depend on your Roku; MP4 (H.264), HLS and MP3 work on current models. To cast dashboards, run the Foyer renderer, give it a long-lived access token from a non-admin Home Assistant user, and enter its address and secret in Foyer's settings in Home Assistant, then use the foyer.show_view action.

Media library

With Media library on in Foyer's settings in Home Assistant (on by default), the TV can browse and play Home Assistant's My media. Add files under Media > My media, or upload them in that panel. Foyer remembers where you stopped and offers to resume, and the next file in the folder plays when one ends.

Files the Roku cannot open as they are, such as DTS or TrueHD audio, H.264 in AVI, or OGG music, are repackaged by Home Assistant while they play. Files whose video itself cannot play on a Roku, such as old XviD or WMV, need converting first: turn on Prepare videos for TV for that TV in Foyer's settings, then choose Convert when the TV asks. Converting runs on your Home Assistant server, one file at a time; the tile shows its progress, and the converted copy is kept in a hidden .foyer folder next to the original.

Removing access

Forget this TV on the Roku clears its saved connection. Revoke in Foyer's settings in Home Assistant stops that TV's access immediately. Revoke access before selling or giving away a paired TV.