overview

My room runs on Home Assistant, self-hosted in Docker on my Pi 5 homelab. It controls my desk and floor lamps, knows whether I'm home, shows where my phone has been, plays Spotify, and can turn my MacBook into a security camera. I use it three ways: a Galaxy tablet mounted on the wall as a kiosk, a phone dashboard, and without looking at a screen at all, through NFC tags and Siri.

The Home Assistant kiosk tablet mounted on the wall above the intercom

features

tap to toggle: I have NFC tags wired to one script. One sits on my bedroom door frame: tap my iPhone against it on the way through and both lamps flip together, on or off.
local lights: Both lamps are on Athom smart plugs running ESPHome, so they're controlled on my own network with no vendor cloud in between. If the internet goes down, the lights still work.
Apple Home and Siri: The HomeKit Bridge integration puts the lamps, the CCTV switch and the camera itself into Apple's Home app, so "hey Siri, lights off" and the Control Center tiles work too. More on that below.
presence and movement: The Home Assistant iPhone app reports my location, which drives home/away state and a map on the dashboards that traces where my phone has been.
battery levels: The iPhone, iPad and macOS companion apps report battery levels, so every device's charge is on the kiosk at a glance.
Spotify and weather: What's playing, next to the day's forecast.
CCTV: One switch turns my MacBook's webcam into a live camera feed on the dashboard. How that works is on its own page.
next trains: A copy of an MBTA station countdown sign, showing when the next trains leave from my stop. More on that below.

apple home

Everything also shows up in Apple's Home app through the HomeKit Bridge integration: both lamps, the CCTV switch, and the MacBook camera as a HomeKit camera. While CCTV is off the camera tile reads No Response. Flip the switch from the Home app and the feed appears a moment later, and tapping it opens a live view. Home Assistant is still the one doing the work; the Home app is just another remote for it.

Apple Home on the iPhone: the live CCTV camera and the bedroom tiles for CCTV, the desk lamp and the floor lamp

the kiosk

The wall tablet runs one dashboard, laid out on a roughly 42-column grid (layout-card's grid layout, not the default Sections view, which can't place cards this precisely). The live panel for the homelab sits top left, the movement map runs down the middle, and the right side has the transit sign with the weather under it. Along the bottom, the camera switch and Spotify are on the left and the lights on the right: desk, floor, then both.

kiosk-mode hides Home Assistant's header and sidebar, but only for the tablet. The tablet signs in as its own Home Assistant user and kiosk-mode targets that user, so my own account still gets the full interface everywhere else. I couldn't do it with a URL flag: the Home Assistant Android app ignores URL paths and always opens the signed-in user's default dashboard.

The kiosk dashboard: homelab panel, movement map, transit sign, weather, CCTV, Spotify and the lights

The tablet itself, and the 3D-printed mount that holds it, are on the wall mount page.

the transit sign

The top right of the kiosk is a copy of the countdown signs in MBTA stations: amber dot-matrix letters on black, with a slight glow. It shows the next two Green Line E trains each way from Museum of Fine Arts, how many minutes until each one arrives, and the time it gets in. The second train in each direction is dimmed, and a train pulling in reads ARR, the same as on the platform.

The transit sign: the next two Green Line E trains to Heath St and to Medford/Tufts, with minutes and arrival times in amber dot-matrix text
tap to switch: Tapping the sign cycles from the E branch at MFA to the D branch at Fenway to the Orange Line at Ruggles. After two minutes without a tap it goes back to MFA, so it's always on the stop I actually use when I walk past.
falls back on its own: If the E branch has a suspension, shuttle buses or a closure at MFA, or just has no predictions, the sign switches to the D branch at Fenway and labels itself FENWAY · E DOWN. If both branches are out it says there's no service instead of showing an empty board.
stale looks stale: While a new station loads, or if a request fails, the sign dims and keeps the last times on screen instead of going blank. A late answer for a station I've already tapped past gets thrown away, so the sign never shows the wrong stop's trains.
fits its cell: The text scales with the smaller of the cell's width and height, so all four lines fit. Home Assistant's aspect-ratio option couldn't size a card this short and wide, so the card is pinned to a fixed height instead.

The MBTA's API needs a key, so the tablet never calls it directly. A route in the same Flask API that runs my misc page fetches predictions and service alerts, picks the station, and returns only the rows the sign needs. Destination names come from the MBTA's own data instead of being typed in. Each station's answer is cached for 20 seconds, so the number of calls to the MBTA stays the same however often the tablet asks. Like the homelab panel, the route only answers inside my tailnet, and the sign itself is a plain HTML/CSS/JS page that Home Assistant serves into an iframe.

the phone dashboard

A single-column version for my phone. Two things fought me here. Setting cards to 100vh behaved differently in the app than in a browser, so every row has a fixed height instead. And the homelab panel sits in an iframe, which swallowed scrolling until the iframe was set to only claim vertical panning, with the scrolling moved inside the panel instead of the page body.

The raw YAML editor also kept mangling the CSS selectors I use for styling, so I edit this dashboard's stored JSON directly, with Home Assistant stopped, using a short Python script.

The single-column phone dashboard with the transit sign, the lights and CCTV switch, the map and the homelab panel

the location bug

For a while my location only updated while I was on home Wi-Fi. The iPhone app's most private location mode will only send updates to a server it can reach securely, and off my home network it had nowhere to send them. Giving Home Assistant a proper HTTPS address inside my tailnet, and telling it to trust the proxy in front of it, fixed it. It's still never reachable from the open internet.

construction

Home Assistant Docker ESPHome HomeKit Bridge HACS layout-card kiosk-mode card-mod NFC MBTA V3 API Tailscale

Home Assistant runs as a plain Docker container rather than Home Assistant OS, using the host's network so it can discover the ESPHome plugs and advertise the HomeKit bridge over mDNS. Its config lives on the Pi's SSD, so it's in the nightly backup, and every config change gets a syntax check before a restart.

architecture

NFC tag / Siri / dashboards → Home Assistant (Pi) → ESPHome plugs / MacBook camera / Spotify
MBTA V3 API → vedsite API (Pi) → transit sign on the kiosk

Everything goes through Home Assistant on the Pi: the tags and Siri trigger the same scripts the dashboards do, so there's one place where a light's state lives. The transit sign is the exception, since it has no state to keep: it asks the API directly.

Source? My config isn't public since it describes my home network. Happy to talk through any part of it though. The API behind the transit sign is on my GitHub.