HydraIssues

peppy-dumpling-32: grant Terminal Screen Recording TCC for screenshot loop
open ops Project: hydracluster Reporter: anonymous 15 May 2026 09:42

Description

Terminal is running on peppy (node-74adf4f8, rupelmonde) but Screen Recording TCC has not been granted. Screencapture returns "could not create image from display" on every attempt, making the kiosk blind to remote agents.

Physical access required (one-time). See hydraheadflatscreen runbook → Post-installation TCC grants for the full procedure.

After granting, start the loop remotely:

hydracluster exec node-74adf4f8 "osascript ..." --shell

---

This issue also surfaces a gap: there is no standalone physical setup guide that can be sent to a site technician or venue contact doing a kiosk visit. The runbook is operator-facing and too detailed. A simple checklist guide is needed.

Suggested location: hydraheadflatscreen/docs/guides/kiosk-physical-setup.md

This guide should cover:
- TCC grants (Screen Recording for Terminal, Microphone for hydraheadflatscreen)
- Autologin verification
- WireGuard tunnel check
- How to verify the kiosk is fully operational before leaving the site

Once created, the URL to the guide in the repo can be shared with anyone doing a physical kiosk setup visit.