# Media Cluster — Android TV / phone client

Native client for the private Media Cluster (alternative to Stremio).

## Features (v0.1)

- Device linking via short code + `/link` page
- Home with **Verder kijken** + configurable shelves
- Detail → ExoPlayer direct play (no transcoding)
- Progress sync to master
- Shelf visibility / order per viewer

## Setup

1. Open `apps/android-tv` in Android Studio.
2. Set `DEFAULT_API_BASE` in `app/build.gradle.kts` if needed (default `https://master.vonas.nl`).
3. On master, set `CLIENT_LINK_BASE_URL` to your admin UI origin (e.g. `https://admin.vonas.nl`) so the TV shows the right link URL.
4. Run migration `20260831010000_viewer_client`.
5. Admin → **Kijkers** → create a viewer account.
6. Install APK on TV → enter code at `/link`.

## API used

- `POST /api/v1/client/device/code`
- `GET /api/v1/client/device/poll`
- `POST /api/v1/link/claim`
- `GET /api/v1/client/home`
- `POST /api/v1/client/play`
- `POST /api/v1/client/progress`
- `GET|PUT /api/v1/client/shelves/prefs`