Working title only. The display name may change later; the release application ID and signing identity stay fixed. Repository:
Batmancpu/Player.
A local-first Android media library inspired by the cinematic presentation of Apple TV and the refined Liquid Glass interface language of iOS 27.
Choose one local folder. Player scans only that folder and its descendants, identifies movies and television episodes, retrieves matching artwork and metadata directly from TMDB, caches everything locally, and presents the collection in a carefully crafted Apple-inspired interface.
- Media files remain on the device and are never uploaded to a Player server.
- No Player backend, media streaming server, account, subscription, advertisement, analytics, or telemetry.
- TMDB is contacted directly for metadata and artwork only. No video bytes, file paths, folder listings, or document URIs are sent.
- Previously indexed metadata and artwork remain available offline.
- The media library is read-only: never move, rename, edit, or delete the user's source files.
- Local playback is now in scope: tap a movie/episode to play its local file, with audio/subtitle track selection, external subtitle loading/download and subtitle-delay controls planned. Playback remains local-only.
The latest signed preview is Player v0.1.91 (versionCode 91) and updates the existing app through Obtainium without uninstalling. APK SHA-256: 7c9ff8287405be9b1f607259608d84a256e5aed1fcc4cea24e3f9b882dd05e17. CI #91 passed 15 Android 15 integration tests, JVM/build, signed APK privacy/identity and permanent-certificate checks.
The offline preview includes one read-only local SAF folder, Room persistence, searchable movie/show browsing, details and basic local Media3 playback with pause/seek/private resume, plus a single-surface Glass Lab dock. The user confirmed on v0.1.79 that four videos were correctly named/year-parsed, the folder persisted in airplane mode and folder switching worked. New preview behavior and remaining permission/cancellation scenarios still need OPPO testing; Phase 1 is not accepted and no FPS/thermal results are claimed. Phase 1 requires no network permission or online metadata. Follow the short preview checklist, Phase 1 checklist, six-phase roadmap and handoff. Never install a CI-only debug APK as an update. Development uses main only; see AGENTS.md.
- AI agent operating rules
- Full product and conversation handoff
- Architecture
- Architecture decisions
- Step-by-step roadmap
- Device test and crash playbook
- Development log
- Known issues and fixes
- Third-party notices
- Android release signing and update continuity
- Chronological project conversation/session log
- Apple Human Interface Guidelines: Materials
- Haze 2.1.0 release and Glass API
- FC Zenith LiquidGlass.kt
- TMDB developer documentation
The implementation licence and all third-party licence obligations must be settled and documented before code is copied or distributed. See DECISIONS.md.
The signed first test release is Player v0.1.51, from successful CI run #51. Add this repository URL in Obtainium and install release v0.1.51. After successful first install, publish a higher-version signed test update and verify installation over the prior version; do not count Phase 1 complete until device acceptance tests pass.