Skip to content

Developpement Build Release

khalilbenaz edited this page Jun 23, 2026 · 2 revisions

Développement, Build & Release

Pile technique

  • Electron 42 (process principal main.js, renderer renderer.js + features.js, preload.js). Durci : sandbox, validation des URL, relais en loopback sauf restream.
  • Lecture : mpegts.js (flux .ts natif Xtream, worker blob: → la CSP autorise worker-src 'self' blob:) avec fallback hls.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/packager via build-portable.js (electron-builder retiré).

Cloudflare Workers (workers/)

  • 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.

Développement local

npm install
npm start

Build (version portable)

# 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.exe

Le build doit être lancé sur la plateforme cible : ffmpeg-static télécharge le binaire ffmpeg correspondant à l'OS lors du npm install.

macOS : l'app n'est pas signée. Au 1er lancement, clic droit → Ouvrir, ou xattr -dr com.apple.quarantine "/Applications/KTV.app".

Release automatique (CI)

Le workflow .github/workflows/build.yml se déclenche sur push d'un tag v* :

  1. Build macOS (macos-14) + Windows (windows-latest) en parallèle.
  2. Zippe en KTV-macos-arm64.zip et KTV-windows-x64.zip.
  3. Attache les binaires à la Release du tag (via softprops/action-gh-release, sans écraser le corps des notes).

Couper une nouvelle version

# 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.

Site (GitHub Pages)

Le site (docs/) est servi par GitHub Pages depuis main / /docs (rebuild automatique au push). URL : https://khalilbenaz.github.io/ktv/

Architecture « 1 connexion »

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.

Clone this wiki locally