# visionLabs Roku

visionLabs Roku is a private Roku app scaffold for viewing home security cameras on a TV.

The current starter path is Frigate-backed, with Roku reading a static inventory of cameras that are managed by Frigate instead of embedding raw camera credentials in the app.

## Product direction

- Brand family follows the user's existing `Labs` naming pattern.
- V1 uses a static packaged camera configuration.
- V2 adds in-app camera and layout editing.
- V3 moves camera metadata and layout persistence to a backend service.

## Technical direction

- Roku SceneGraph app
- Camera feeds delivered from Frigate in a Roku-friendly format, ideally HLS
- Static JSON config for the first prototype
- Future backend for editing, persistence, and auth

## Project layout

- `manifest` - Roku channel metadata
- `source/main.brs` - app entry point
- `components/MainScene.xml` - initial SceneGraph UI
- `components/MainScene.brs` - scene behavior
- `config/cameras.json` - static Frigate-backed starter camera config
- `docs/FRIGATE_SETUP.md` - notes for mapping cameras through Frigate
- `docs/ROADMAP.md` - delivery phases and constraints

## Notes

Roku is not a great target for raw RTSP feeds. With Frigate in the middle, the clean path is to let Frigate manage discovery, auth, and stream brokering, then expose a Roku-friendly live feed format from there.

## Next steps

1. Set the real Frigate base URL in `config/cameras.json`
2. Map the four starter cameras in Frigate using the same IDs as the Roku config
3. Load config into the UI
4. Render a static multi-camera grid
5. Add edit mode and persistence strategy