- Python 42.9%
- Kotlin 31.4%
- TypeScript 21.2%
- CSS 3.9%
- JavaScript 0.2%
- Other 0.2%
| Filename | Latest commit message | Latest commit date |
|---|---|---|
|
|
||
| android-tv | ||
| docs | ||
| ops | ||
| server | ||
| web | ||
| .env.example | ||
| .gitignore | ||
| AGENTS.md | ||
| compose.yaml | ||
| README.md | ||
TVChouqs
Un seul dépôt, deux parties.
android-tv/: l’application Android TV (l’APK), compilée avec./gradlew assembleRelease.server/etweb/(aveccompose.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 dansdocs/).local.properties,keystore.properties,.envet 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 (
/docset/openapi.jsonsur 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.