No description
  • Python 42.9%
  • Kotlin 31.4%
  • TypeScript 21.2%
  • CSS 3.9%
  • JavaScript 0.2%
  • Other 0.2%
Find a file
Repository files (latest commit first)
Filename Latest commit message Latest commit date
Mathieu 4cbe94dbe8 README: layout of the single repository (Android TV app, server and PWA)
Co-Authored-By: Claude Sonnet 5.5 <noreply@anthropic.com>
2026-11-15 10:42:37 +01:00
android-tv TV app 0.13.36: film sheet redesign, upcoming episodes, replays tracking, Star Academy portal, per-device accounts, network status, TV key on channel 1 2026-11-15 10:36:50 +01:00
docs Server, PWA player and console: web player (Regarder), dark console with mobile menu and quick code, per-device provider accounts, Star Academy portal with watch history, upcoming episodes (tvlist v4), long series fix, catalogue update button 2026-11-15 10:36:50 +01:00
ops Server, PWA player and console: web player (Regarder), dark console with mobile menu and quick code, per-device provider accounts, Star Academy portal with watch history, upcoming episodes (tvlist v4), long series fix, catalogue update button 2026-11-15 10:36:50 +01:00
server Server, PWA player and console: web player (Regarder), dark console with mobile menu and quick code, per-device provider accounts, Star Academy portal with watch history, upcoming episodes (tvlist v4), long series fix, catalogue update button 2026-11-15 10:36:50 +01:00
web Server, PWA player and console: web player (Regarder), dark console with mobile menu and quick code, per-device provider accounts, Star Academy portal with watch history, upcoming episodes (tvlist v4), long series fix, catalogue update button 2026-11-15 10:36:50 +01:00
.env.example TVChouqs V1 : API, console, client Android TV et déploiement LXC 2026-11-07 10:09:21 +01:00
.gitignore TVChouqs V1 : API, console, client Android TV et déploiement LXC 2026-11-07 10:09:21 +01:00
AGENTS.md Server, PWA player and console: web player (Regarder), dark console with mobile menu and quick code, per-device provider accounts, Star Academy portal with watch history, upcoming episodes (tvlist v4), long series fix, catalogue update button 2026-11-15 10:36:50 +01:00
compose.yaml Server, PWA player and console: web player (Regarder), dark console with mobile menu and quick code, per-device provider accounts, Star Academy portal with watch history, upcoming episodes (tvlist v4), long series fix, catalogue update button 2026-11-15 10:36:50 +01:00
README.md README: layout of the single repository (Android TV app, server and PWA) 2026-11-15 10:42:37 +01:00

TVChouqs

Un seul dépôt, deux parties.

  • android-tv/ : l’application Android TV (l’APK), compilée avec ./gradlew assembleRelease.
  • server/ et web/ (avec compose.yaml, ops/, docs/) : le logiciel serveur et les PWA (administration et lecteur « Regarder » iPhone / PC), déployé avec Docker Compose.

Le serveur et l’application se parlent par l’API /api/v1/device (contrat dans docs/). local.properties, keystore.properties, .env et les clés de signature restent locaux et ne sont jamais commités.

Accueil multimédia privé pour Sony Google TV : client Android TV, serveur local et PWA d’administration.

État au 7 novembre 2026

Bloc État
Serveur (FastAPI + PostgreSQL) Implémenté et déployé sur le LXC 133 tvchouqs (192.168.5.26). 24 tests automatisés passent ; parcours API vérifié contre le vrai Dispatcharr (recherche, fiches, sources, URL de lecture, direct, guide).
PWA d’administration Implémentée : services, profils/groupe/PIN, accès Enfants, accueil TV, raccourcis, appareils, catalogue et correspondances TMDB, favoris, corbeille 7 jours, sauvegardes, diagnostic des services.
Client Android TV Implémenté et compilé (debug et release, 3,8 Mo). Installé sur la Sony et accueil par défaut depuis le 7 novembre ; essais partiels, voir la matrice.
Yamtrack Chaque profil se relie à son compte (webhook Jellyfin de Yamtrack) ; « en cours » et « vu » envoyés en arrière-plan. Première écriture réelle à vérifier.
HTTPS https://tv54.chouqs.xyz pour la PWA (LAN) ; la TV reste en HTTP local.
Forgejo, keystore À faire (voir points ouverts).

Architecture

  • android-tv/ : Kotlin, Compose for TV, AndroidX Media3/ExoPlayer. Aucune clé de service dans l’APK : un jeton d’appareil obtenu par appairage.
  • server/ : Python 3.12, FastAPI, SQLAlchemy 2, Alembic, PostgreSQL 16. Index local du catalogue Dispatcharr, identités stables, favoris, progression, corbeille, intégrations.
  • web/ : React, TypeScript, Vite ; PWA d’administration uniquement, servie par Nginx qui relaie /api/.
  • Déploiement : Docker Compose, seule méthode V1 (voir exploitation).
  • Contrat HTTP : OpenAPI généré par FastAPI (/docs et /openapi.json sur l’API).

Décisions et limites : architecture. Matrice : acceptation.

Développement

Le LXC 133 est l’environnement de développement et d’exécution (Docker, Node 22, JDK 21, SDK Android 37, Playwright). Le code de référence est dans /opt/tvchouqs (dépôt Git).

# Serveur : tests
cd server && python3 -m venv .venv && .venv/bin/pip install -r requirements-dev.txt && .venv/bin/pytest -q
# Pile complète (PostgreSQL, API, PWA sur :8080)
cp .env.example .env   # puis remplacer toutes les valeurs
docker compose up -d --build
# PWA en développement (proxy /api vers :8000)
cd web && npm install && npm run dev
# APK
cd android-tv && ANDROID_HOME=/opt/android-sdk ./gradlew assembleDebug   # ou assembleRelease

Sécurité

Ne jamais commiter .env, keystore Android, keystore.properties, tokens, clés API ou URL de flux signées. Les clés des services se saisissent dans la PWA et sont chiffrées en base (clé APP_SECRET_KEY). Les journaux et réponses à la TV n’incluent ni clé ni identifiants fournisseur.

Attention : ce dossier est aussi publié par le serveur web du NAS (http://192.168.5.194/AppTV/... répond). Ne jamais y déposer .env, keystore ou sauvegardes.