30 lines
1 KiB
Markdown
30 lines
1 KiB
Markdown
# 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`
|