Repository navigation
Developpement Build Release
-
Electron 42 (process principal
main.js, rendererrenderer.js+features.js,preload.js). Durci :sandbox, validation des URL, relais en loopback sauf restream. - Lecture :
mpegts.js(flux.tsnatif Xtream, workerblob:→ la CSP autoriseworker-src 'self' blob:) avec fallbackhls.js. -
ffmpeg-static: enregistrement (copie de flux), relais, sonde de résolution, transcodage 4K matériel (VideoToolbox). - cloudflared : tunnel public pour le restream.
- Packaging :
@electron/packagerviabuild-portable.js(electron-builder retiré).
-
ktv-tmdb: proxy TMDB (token en secret serveur). -
restream-pointer: auto-découverte du restream (auth par secret + URL limitée aux tunnels*.trycloudflare.com). -
ktv-epg: EPG sport maison. - Déploiement :
cd workers/<x> && npx wrangler deploy.
npm install
npm start# macOS Apple Silicon (sur un Mac M1/M2/M3)
npm run build:mac # -> portable/KTV-darwin-arm64/KTV.app
# Windows (sur Windows)
npm run build:win # -> portable/KTV-win32-x64/KTV.exeLe build doit être lancé sur la plateforme cible :
ffmpeg-statictélécharge le binaire ffmpeg correspondant à l'OS lors dunpm install.
macOS : l'app n'est pas signée. Au 1er lancement, clic droit → Ouvrir, ou
xattr -dr com.apple.quarantine "/Applications/KTV.app".
Le workflow .github/workflows/build.yml se déclenche sur push d'un tag v* :
- Build macOS (macos-14) + Windows (windows-latest) en parallèle.
- Zippe en
KTV-macos-arm64.zipetKTV-windows-x64.zip. -
Attache les binaires à la Release du tag (via
softprops/action-gh-release, sans écraser le corps des notes).
# 1. Bumper la version dans package.json (ex. 1.10.0)
# 2. Commit + push sur main
# 3. Créer la release (pousse le tag et déclenche le build des 2 binaires) :
gh release create v1.10.0 --target main \
--title "KTV v1.10.0 — …" \
--notes "Plateformes: all
## Nouveautés
- …"Pense au marqueur
Plateformes: …dans les notes pour la notification ciblée — voir Mises à jour.
Le site (docs/) est servi par GitHub Pages depuis main / /docs (rebuild automatique au push). URL : https://khalilbenaz.github.io/ktv/
Lecture, enregistrement et restream passent par un relais local unique (1 connexion fournisseur → N consommateurs). Les ffmpeg orphelins sont nettoyés au démarrage et à la fermeture. Voir Enregistrement & Restream.
Utilisation
Aller plus loin