Jeena
3635a4ed74
BACK from a video dropped the user on a random spot (often the search screen, #2): the restore token was only bumped when it was already >= 1, so the very first back never re-focused anything, and HomeRowsViewModel refresh() cleared the continue-watching rows synchronously, disposing the rows before their focus-restore effect could run. Bump the token on every playing -> not-playing transition and keep the rows alive during a refresh instead. Refs #2 |
||
|---|---|---|
| app | ||
| docs | ||
| gradle | ||
| scripts | ||
| .gitignore | ||
| AGENTS.md | ||
| BACKLOG.md | ||
| build.gradle.kts | ||
| gradle.properties | ||
| gradlew | ||
| gradlew.bat | ||
| LICENSE | ||
| README.md | ||
| settings.gradle.kts | ||
| TESTS.md | ||
JTube TV
JTube TV is an Android TV app for PeerTube. It puts a PeerTube instance on the big screen the way SmartTube puts YouTube there: browse from the couch, play with the remote, nothing else in the way.
It talks to any PeerTube instance over the REST API. The default is tube.jeena.net, my own instance, where most videos are private family uploads. Signing in matters because "My videos" shows them all, privacy levels included.
What it looks like
Screenshots come from a demo instance serving real, CC-licensed open-movie content, courtesy of the Blender Foundation movies and the A propos de PeerTube channel. All of it plays in the app.
The home screen. Continue watching picks up at the position the server saved, new videos first, page after page.
A slide-in drawer opens with the left D-pad button. My videos shows your own uploads, every privacy level included, with a badge on anything not public.
Channels, one row per owner, with video and play counts on every card.
The player speaks remote: play and pause, seek back and forward, a seek bar with position and duration. Watching is reported to the server every 20 seconds, so where you left off survives the app.
What it does in v0.1
- Sign in once. The app exchanges your username and password for OAuth tokens and stores only those, encrypted with the Android Keystore. The password itself is never kept.
- Home with Continue watching and New videos.
- Browse the instance's public videos, and search them by title.
- My videos: every video you own, private, internal and unlisted included.
- Channels: local channels with their videos, plus your subscriptions and your server-side watch history.
- Player: HLS, with a progressive MP4 fallback, resume from the saved position, and watching reports.
What it deliberately does not do (yet, or ever): uploading, editing, deleting, managing subscriptions. That's tracked in BACKLOG.md.
Build
Requirements: JDK 17 or newer (21 recommended) and an Android SDK with platform 35. The Gradle wrapper is checked in, so no local Gradle install is needed.
./gradlew :app:assembleDebug
Then put it on the TV:
adb connect <tv-ip>:<port>
adb install -r app/build/outputs/apk/debug/app-debug.apk
Architecture
A single-module app, deliberately small:
data/api— Retrofit interface and kotlinx-serialization DTOs for the PeerTube API.data/auth— TokenStore, the encrypted preference storage for tokens.data/network— OkHttp/Retrofit wiring: dynamic base URL, bearer token interceptor, single-flight token refresh.data/PeerTubeRepository.kt— one suspend-call surface for the whole UI.ui/— Compose for TV screens, one for each of the destinations above.- No DI framework, no database. The service locator is
AppGraph.
License
JTube TV is free software under GPL-3.0-or-later.