No description
  • Rust 95.7%
  • HTML 1.6%
  • Kotlin 1.1%
  • JavaScript 1%
  • CSS 0.4%
  • Other 0.1%
Find a file
redik drion aae55201b2
All checks were successful
serveur / image (push) Successful in 4m39s
CI : publier l'image avec un jeton limité aux paquets
Le jeton automatique des Actions de Forgejo reçoit 401 en publiant dans
le registre. REGISTRE_JETON est un jeton de drion limité aux paquets,
rangé dans les secrets du dépôt.

Co-Authored-By: Claude Opus 5.5 <noreply@anthropic.com>
2026-11-17 14:24:55 +01:00
.cargo Dépôt : plus de chemins de machine, scripts Unix en LF 2026-11-16 15:14:37 +01:00
.forgejo/workflows CI : publier l'image avec un jeton limité aux paquets 2026-11-17 14:24:55 +01:00
.github Release : ne signer et ne publier que ce que chaque travail a compilé 2026-11-16 20:00:45 +01:00
crates Serveur : l'image se construit sur la forge, la veille suit le registre 2026-11-17 14:15:15 +01:00
deploy Release : ne signer et ne publier que ce que chaque travail a compilé 2026-11-16 20:00:45 +01:00
installer Client : démarrer avec Windows, le vocal depuis l'icône, la place du stream détaché 2026-11-12 23:09:01 +01:00
.dockerignore Déploiement Docker : image publiée sur GHCR, stack Portainer, mises à jour depuis GitHub 2026-08-15 22:35:47 +02:00
.gitattributes Dépôt : plus de chemins de machine, scripts Unix en LF 2026-11-16 15:14:37 +01:00
.gitignore iOS, étape 1 : l'appli Tauri compile et tourne sur iPhone 2026-10-05 20:51:00 +02:00
AUDIT-0.1.51.md L'audit 0.1.51 dit ce qui est corrigé, par quel commit, et ce qui reste à décider 2026-09-28 18:43:47 +02:00
AUDIT.md Version 0.1.4 2026-08-17 21:23:47 +02:00
Cargo.lock Mises à jour : chercher d'abord sur git.baws.fun, GitHub en secours ; version 0.2.1 2026-11-16 23:13:44 +01:00
Cargo.toml Mises à jour : chercher d'abord sur git.baws.fun, GitHub en secours ; version 0.2.1 2026-11-16 23:13:44 +01:00
deny.toml CI : l'appli Android vérifiée à chaque poussée 2026-11-16 15:36:26 +01:00
PLAN-CLIPS.md L'atelier juste à l'oreille : les curseurs de son s'entendent dans l'aperçu, et une coupe sans réencodage ne décale plus le son 2026-09-27 17:54:15 +02:00
PLAN-MUSIQUE.md Le confort (C4) : le profil NVENC des clips, « Retirer du serveur », et yt-dlp qui se tient à jour 2026-09-15 03:03:30 +02:00
PLAN-PORTE.md Le lien d'une porte est complet, https:// compris : l'adresse web se règle dans Admin → Serveur, et une porte tient six heures 2026-09-22 23:37:11 +02:00
PLAN-STREAM.md Diffusion : l'encodeur logiciel se voit quand la carte sait encoder 2026-11-16 14:00:15 +01:00
PLAN-VALORANT-2.md V9.4 : comparer deux membres, et la progression 2026-10-19 20:30:58 +02:00
PLAN-VALORANT.md VALORANT, saison 2 : le plan — comptes joués, tableau de bord, carte tactique 2026-10-19 20:30:58 +02:00
README.md VALORANT, saison 2 : le plan — comptes joués, tableau de bord, carte tactique 2026-10-19 20:30:58 +02:00

ki-chat

Serveur de chat privé façon Discord, 100 % Rust, taillé pour le jeu entre amis : chat texte temps réel, vocal ultra-basse latence avec débruitage neuronal, partage d'écran 60 i/s avec le son du jeu isolé, enregistreur de clips rétroactif à la touche, visionneuse photo et vidéo intégrée, bot musique sans publicité et intégration VALORANT poussée — pour ~30 personnes, sur une machine modeste à 5 €/mois.


Sommaire

  1. En un coup d'œil
  2. Installer & Jouer (côté joueur)
  3. Héberger son serveur (côté admin)
  4. Les fonctionnalités en détail
  5. Architecture & Développement
  6. Coûts réels
  7. Feuille de route

En un coup d'œil

  • Vocal ultra-basse latence (~60–80 ms) : Moteur audio WASAPI natif (sans passer par les couches de mixage Windows destructrices), codecs Opus 1.6.1 avec redondance neuronale DRED et masquage de perte Deep PLC, débruitage neuronal studio DeepFilterNet3 en local (~1 ms de calcul), détection de parole Silero VAD et annulation d'écho acoustique SpeexDSP.
  • Partage d'écran 60 i/s fluide : Windows Graphics Capture (matériel, sans injection), encodage matériel NVENC direct (sans SDK ni CUDA) ou openh264, flux QUIC chiffré dédié par trame sans blocage de ligne, et boucle audio WASAPI par processus qui isole tout le système sauf ki-chat (le son du jeu sans l'écho des copains).
  • L'enregistreur de clips (C1) : Une touche globale en plein jeu (Alt+F10 par défaut), et les 30 dernières secondes sont enregistrées sur le disque (Vidéos\ki-chat\). Encodage direct en mémoire tampon circulaire, son découpé en pistes séparées (mix stéréo, son du jeu, micro nettoyé, voix des copains) et galerie de relecture instantanée dans l'application.
  • Visionneuse photo & vidéo intégrée (C0) : Finies les ouvertures intempestives dans le navigateur web. Les photos et vidéos partagées dans le chat s'ouvrent en grand dans ki-chat (zoom, avance à la seconde, son synchronisé avec l'annulateur d'écho). Les vidéos envoyées sont normalisées par ffmpeg côté serveur en MP4 universel et téléversées par morceaux de 8 Mo (jusqu'à 512 Mo).
  • Overlay en jeu « qui parle » : Connaître les locuteurs sans quitter la partie. Fenêtre découpée à la forme exacte des pastilles, transparente aux clics, invisible pour les anti-triches (Riot Vanguard, Easy Anti-Cheat) car rien n'est injecté.
  • Intégration VALORANT : Statut en jeu en direct (partie en cours, score, carte, taille d'escouade) lu en lecture seule sur le client Riot local ; fiches de joueurs qui s'accumulent (soixante matchs, cent points de RR) avec courbe de progression, ADR, KAST, premiers sangs, clutchs, agents et cartes ; page du groupe en onglets avec records, classement triable, fil des matchs joués ensemble, duos et heures de jeu ; boutique de skins du jour et fil de jeu automatique annonçant les victoires dans le salon textuel.
  • Bot musique de groupe : Membre virtuel pilotable par une bannière épurée au-dessus du chat. Recherche YouTube/SoundCloud sans publicité, streaming Opus direct par le serveur (aucun fichier temporaire sur disque ni chez le client), playlists partagées, mise en pause automatique en salon vide et reprise après redémarrage.
  • Soundboard : Des sons à la touche (un clic, ou les touches 1 à 9), entendus par tout le salon vocal — mixés à la voix, ou seuls micro fermé, sans rien de plus dans le protocole. Chacun dépose ses .wav ou .mp3 (30 s au plus) dans son dossier sons\soundboard.
  • Souveraineté & Respect de la vie privée : Tout est chiffré en transit (QUIC TLS 1.3), et la voix et la vidéo le sont une seconde fois en XChaCha20-Poly1305 ; ce n'est pas du bout en bout : le serveur distribue ces clés et les détient (il en a besoin pour le bot musique et la voix des invités web). La confidentialité d'un salon privé repose donc sur le serveur, qui est le vôtre. Mots de passe hachés en Argon2id, secrets protégés par le coffre natif du système (DPAPI Windows / Trousseau macOS). Zéro pistage, zéro télémétrie commerciale.

Installer & Jouer (côté joueur)

Windows

  1. Télécharger ki-chat-setup.exe depuis la dernière version publiée.
  2. Double-cliquer pour installer.

Rien d'autre à installer : L'exécutable est lié statiquement à la bibliothèque C de Windows. Il ne réclame aucun redistribuable externe (« Visual C++ Redistributable ») et ne demande aucun droit administrateur.

L'application s'installe dans le profil de l'utilisateur (%LOCALAPPDATA%\Programs\ki-chat), ce qui lui permet d'appliquer les mises à jour automatiques sans jamais déclencher d'invite UAC agaçante.

Le binaire n'étant pas signé par un certificat d'autorité commercial (très coûteux), Windows SmartScreen peut afficher un avertissement au tout premier lancement : cliquer sur Informations complémentaires → Exécuter quand même. Cet avertissement s'efface à mesure que le binaire circule.

macOS

L'installation se fait en une commande dans le Terminal :

curl -fsSL https://raw.githubusercontent.com/Redik123/ki-chat/main/installer/macos/install.sh | sh

Le script télécharge la dernière release, déploie ki-chat.app dans ~/Applications (dossier utilisateur sans besoin de mot de passe sudo) et ouvre l'application. Relancer cette commande effectue la mise à jour. Pour les adeptes du clic, l'archive classique ki-chat-macos.pkg est également fournie avec chaque release.

  • Binaire universel : Compatible nativement puces Apple Silicon (M1/M2/M3/M4) et processeurs Intel (macOS 11 Big Sur minimum).
  • Autorisation Accessibilité : Pour que le push-to-talk fonctionne lorsque ki-chat est en arrière-plan, activer ki-chat dans Réglages Système → Confidentialité et sécurité → Accessibilité.
  • Note sur macOS : Le visionnage de stream fonctionne parfaitement avec le son ; la diffusion de son propre écran et l'overlay en jeu sont réservés à Windows pour le moment.

Raccourcis globaux & Push-to-talk

Surveillés sur un fil système dédié à 100 Hz (GetAsyncKeystate / hooks bas niveau), les raccourcis ne ratent jamais une frappe brève, même au cœur d'une partie effrénée :

Action Raccourci par défaut Personnalisable
Sauver un clip (30 secondes) Alt + F10 (tenu par Windows : marche au-dessus du jeu) Oui (⚙ → Clips)
Push-to-talk (Parler) Désactivé par défaut Oui (⚙ → Audio)
Couper / Rétablir le micro Non assigné Oui (⚙ → Audio)
Sourdine casque (Rendre sourd) Non assigné Oui (⚙ → Audio)

Un mode activation vocale épaulé par le réseau neuronal Silero VAD permet de jouer micro ouvert sans transmettre les bruits de clavier mécanique, les souffles ou les clics de souris.

Le Docteur audio

« Mon micro ne marche plus quand je lance mon jeu » est un problème fréquent sous Windows : les moteurs anti-triche ou les suites logicielles pour casques (SteelSeries Sonar, Razer Synapse, Voicemeeter, NVIDIA Broadcast) s'approprient les voies audio en mode exclusif sans prévenir.

Dans ⚙ → Aide & diagnostics → Docteur audio, ki-chat analyse en temps réel votre configuration :

  • Détecte les logiciels et pilotes virtuels qui s'interposent et indique la manipulation exacte pour libérer la voie.
  • Relève les trames incomplètes et prévient si la voie de capture a été rendue muette par un tiers.
  • Propose l'activation du mode Sortie audio robuste (tampon de 200 ms) pour garantir un son cristallin même lorsque le processeur est saturé par un jeu lourd.

Héberger son serveur (côté admin)

Déploiement en un clic (Docker / Portainer)

Le serveur ne requiert aucune compilation manuelle. Une image Docker multi-architecture (amd64 & arm64) est compilée et publiée à chaque mise à jour sur GitHub Packages (GHCR) :

docker run -d --name ki-chat --restart unless-stopped \
  -e KI_TOKEN=mon_code_invitation_secret \
  -p 9987:9987/udp -p 8080:8080/tcp \
  -v ki-chat-data:/data \
  ghcr.io/redik123/ki-chat-server:latest

Pour les utilisateurs de Portainer, copiez simplement le fichier deploy/docker-compose.yml dans l'éditeur de Stack et définissez votre variable KI_TOKEN.

Réseau : le port 9987/udp

Le protocole repose sur QUIC (HTTP/3 sous-jacent avec TLS 1.3) :

  • Port 9987/udp (INDISPENSABLE) : Tout le trafic applicatif (authentification, chat, présence, salons vocaux SFU, diffusion d'écran en direct) transite sur ce port unique. Si ce port UDP n'est pas redirigé ou ouvert dans votre pare-feu, les clients ne pourront pas se connecter.
  • Port 8080/tcp (HTTPS) : Utilisé pour le téléchargement direct des fichiers/médias partagés, la consultation sécurisée des diagnostics par l'administrateur, et les pages des portes web (avec l'avertissement du navigateur : certificat auto-signé).
  • Port 443/tcp (facultatif, 0.1.44) : Une seconde écoute HTTPS du même serveur derrière un certificat public (KI_TLS_CERT / KI_TLS_KEY, relu chaque heure), pour que le lien d'une porte web s'ouvre sans avertissement — https://ton-domaine/salon1. Le 8080, épinglé par les clients, ne change pas. Guide : deploy/DEPLOY-DOCKER.md, « Porte web et certificat public ».

Mises à jour automatiques

  • Watchtower (recommandé, inclus dans docker-compose.yml) : Vérifie les nouvelles images sur GHCR toutes les 5 minutes et redémarre le conteneur en douceur.
  • Persistance garantie : Le volume /data conserve l'intégralité des comptes (users.json), des salons et de l'historique (channels/), des certificats TLS auto-signés (quic-cert.der), de l'identité du serveur (server.json) et du journal d'audit (audit.jsonl). Une mise à jour du conteneur ne détruit aucune donnée.

Variables d'environnement

Variable Valeur par défaut Description
KI_TOKEN (tiré au hasard, écrit dans le journal) Code d'invitation maître pour la création du premier compte (propriétaire). Les valeurs d'exemple connues (changeme, change_moi…) ne créent aucun compte
KI_UDP_PORT 9987 Port QUIC (contrôle, vocal, vidéo)
KI_HTTP_PORT 8080 Port HTTPS (fichiers, diagnostics)
KI_DATA_DIR ./data Répertoire de persistance sur disque
KI_FILES_MAX_BYTES 2147483648 (2 Gio) Quota de stockage total des fichiers partagés (purge automatique LRU)
KI_FILES_TTL_DAYS 30 Durée de rétention des fichiers ordinaires (en jours, 0 = illimité)
KI_FILES_MAX_FILE_MB 512 Taille maximale pour un média téléversé par morceaux
KI_CLIPS_MAX_BYTES 8589934592 (8 Gio) Quota des clips partagés (data/clips/, purge LRU à part des fichiers)
KI_CLIPS_TTL_DAYS 60 Durée de rétention des clips partagés (en jours, 0 = illimité)
KI_POLICE (DejaVu Sans Bold) Police .ttf du titre des exports de clips
KI_HENRIK_KEY (vide) Clé d'API HenrikDev pour l'intégration VALORANT
KI_FFMPEG / KI_FFPROBE ffmpeg / ffprobe Exécutables vidéo pour la normalisation et l'extraction audio
KI_YTDLP data/outils/yt-dlp (mis à jour chaque jour depuis la release yt-dlp), sinon yt-dlp yt-dlp du bot musique ; posé par l'admin, plus de mise à jour automatique
KI_PUBLIC_URL (l'adresse par laquelle le client parle au serveur) Adresse publique (https://hote:port) pour les liens que suit un téléphone (QR code de l'atelier) et le lien des portes web. L'adresse réglée dans Admin → Serveur l'emporte
KI_PUBLIC_QUIC (l'hôte de KI_PUBLIC_URL et KI_UDP_PORT) Adresse à saisir dans ki-chat (hote:9987), telle qu'une invitation offerte par une porte web la donne
KI_TLS_CERT / KI_TLS_KEY (vides) Certificat public et sa clé (PEM, Let's Encrypt) : ouvre une seconde écoute HTTPS pour les navigateurs, relue chaque heure ; l'écoute 8080 ne change pas
KI_TLS_PORT 8443 Port de cette seconde écoute dans le conteneur (publié sur 443 par Docker)

Diagnostics partagés & Rapports de plantage

  • Tableau de bord (Administration → Tableau de bord, réservé à l'administrateur) : version et uptime du serveur, connectés et salons vocaux, diffusions en cours, stocks de fichiers et de clips face à leur plafond, disque libre et mémoire, bot musique, service VALORANT et résumé des diagnostics par version — rafraîchi toutes les trente secondes. Et le débit réseau du serveur (0.1.50), entrant et sortant, avec sa courbe sur dix minutes, la pointe et le total depuis le démarrage — relu toutes les cinq secondes, à part : le serveur ne fait que relire les compteurs que le noyau Linux tient déjà (/proc/net/dev, interface de la route par défaut), rien sur le chemin de la voix ni des streams.
  • Fichiers partagés (0.1.46) (Administration → Fichiers, pour qui peut supprimer les messages) : tous les fichiers envoyés sur le serveur — qui les a envoyés, dans quel salon, quand, ce qu'ils pèsent —, filtrés par membre (« Kevin — 15 fichiers, 1,2 Go ») et par genre (vidéos, images, autres), triés par date ou par poids, à ouvrir dans la visionneuse. On coche (ou « tout cocher ») et l'on supprime en lot, après confirmation : les fichiers quittent le disque, et les messages qui les partageaient quittent le chat. Journalisé dans l'audit.

En cochant « Partager mes diagnostics » dans les paramètres de l'application, les joueurs transmettent toutes les 10 minutes leur journal technique (modèle GPU, état des pilotes, statistiques réseau et audio — à l'exclusion stricte de tout message ou donnée vocale).

Les administrateurs peuvent consulter et analyser les rapports d'erreurs et de plantages directement depuis l'onglet Diagnostics du panneau d'administration, ou via l'API protégée par jeton :

curl -k -H "x-ki-admin: $(cat data/diag.token)" https://ton-serveur:8080/diag

Les fonctionnalités en détail

Vocal haute fidélité & IA

  • Pipeline audio WASAPI natif : Conçu spécialement pour contourner les latences de mixage génériques de Windows (eConsole pour cibler le périphérique de jeu).
  • Opus 1.6.1 de pointe : Compilé avec les extensions de pointe issues des sources officielles via crates/ki-opus :
    • DRED (Deep Redundancy) : En cas de perte de paquets, jusqu'à 1 seconde de voix passée est resynthétisée par réseau neuronal.
    • Deep PLC : Masquage neuronal des trames perdues lorsqu'aucune redondance n'est disponible.
  • Réduction de bruit DeepFilterNet3 : Réseau de neurones de qualité studio exécuté en local via le moteur d'inférence Tract (~1 ms de calcul CPU par trame de 20 ms), éliminant bruits de fond, climatiseurs et frappes de touches sans dénaturer le timbre de la voix.
  • Interpolation cubique de Hermite : Le rééchantillonnage de 44,1 kHz à 48 kHz réduit l'erreur harmonique d'un facteur 53 par rapport à une interpolation linéaire classique, prévenant tout micro-craquement.
  • Réseau résilient & DSCP EF : Paquets vocaux marqués Expedited Forwarding pour être priorisés par les routeurs DiffServ, couplés à un tampon de gigue adaptatif oscillant entre 40 et 160 ms.

Partage d'écran & Son du jeu

  • Regarder à sa façon : le stream d'un copain se regarde dans ki-chat, ou détaché dans sa propre fenêtre — sur le second écran, ou en plein écran (F11, double-clic, Échap pour en sortir), avec le volume du son du jeu sous la main.

  • Un encodeur qui se règle tout seul : quand la carte ne tient pas la cadence demandée (une GTX 1080 à 1080p60, par exemple), la diffusion passe seule en 30 i/s, puis en 720p, le dit au streamer et au journal — et remonte prudemment quand la marge revient.

  • Deux qualités (0.1.46) : un spectateur dont la connexion ne suit pas passe tout seul sur une seconde image, plus petite (720p30 à 360p30 selon ce qu'il avale) et fluide, pendant que ceux qui ont la fibre gardent la haute — au lieu de tirer tout le monde vers le bas. Il retente la haute de temps en temps. La résolution suit le débit quand le réseau le bride (plus de 1080p en bouillie à 1 Mbit/s), et le serveur voit aussi quand c'est la connexion du streamer qui ne suit pas, et baisse le débit avant que le retard ne s'accumule. Personne ne regarde la haute : elle ne part plus.

  • Jusqu'à 60 Mbit/s, et le public visible (0.1.50) : le débit se règle jusqu'à 60 Mbit/s, et un stream à plusieurs spectateurs ne devient plus flou pour tout le monde — le serveur ne prend plus le passage d'une trame clé pour une connexion saturée. Le streamer voit combien de personnes le regardent, et qui ; le salon aussi, à côté de l'icône d'écran.

  • Windows Graphics Capture (WGC) : Capture matérielle au niveau de l'OS sans accrochage Direct3D ni injection de DLL dans les processus de jeu.

  • NVENC sans SDK tiers : Chargement dynamique direct de nvEncodeAPI64.dll présent dans les pilotes NVIDIA modernes (API 12.0+) ; repli transparent sur l'encodeur logiciel openh264 en cas de matériel non supporté.

  • Boucle WASAPI « tout sauf ki-chat » : La capture audio du stream intercepte les sons de tous les processus Windows à l'exception de l'exécutable de ki-chat lui-même. Les spectateurs entendent le jeu et la musique du diffuseur, mais n'entendent jamais leur propre écho en retour.

  • Chiffrement des trames : Chaque flux vidéo est chiffré par le diffuseur en XChaCha20-Poly1305 avec une clé tirée pour la diffusion. Cette clé passe par le serveur, qui la remet aux seuls spectateurs autorisés : il pourrait donc déchiffrer, et le relais ne tient qu'à ce qu'il est le vôtre — ce n'est pas du bout en bout.

Clips : les 30 dernières secondes à la touche

(Livré avec le jalon C1 en version 0.1.35)

Ne laissez plus passer un tir incroyable ou un moment mémorable :

[ Jeu / Écran ] ──► Capture WGC ──► NV12 (proc. vidéo D3D) ──► NVENC (GOP 1s) ──► Tampon circulaire RAM (30s)
                    └──────────────── tout sur la carte graphique ─────────────┘
[ Son du jeu ]  ──► WASAPI Loopback ───────────────► ┌── Alt+F10 ────────────────┐
[ Micro traité] ──► Filtres IA / Opus ─────────────► │ Écriture MP4 multi-pistes │
[ Voix salon ]  ──► Moteur vocal ──────────────────► └──► Vidéos\ki-chat\ ───────┘
  1. Invisible en jeu (0.1.47) : l'image ne passe jamais par le processeur. Capture, conversion NV12 (BT.709, par le processeur vidéo de Direct3D) et NVENC partagent un même device sur la carte NVIDIA, et NVENC n'utilise aucune option qui passe par CUDA — les cœurs qui dessinent le jeu ne sont pas touchés. Mesuré sur une RTX 3080 : ~1-3 % d'un cœur au lieu de ~26 %, 0,2 % du moteur 3D de la carte au lieu de ~10 %. La capture se fait au rythme demandé (60 i/s) même sur un écran à 280 Hz. Sans carte NVIDIA, l'ancien chemin prend le relais (plus lourd : « Légère » à 30 i/s conseillée).
  2. Tampon mémoire léger : L'enregistreur conserve les N dernières secondes en mémoire vive (réglable de 15 à 120 secondes, 30 s par défaut). Rien n'est écrit sur le disque tant que la touche n'a pas été pressée, et l'écriture du fichier se fait en priorité « arrière-plan ».
  3. Pistes audio indépendantes : Le fichier .mp4 généré par le Sink Writer de Media Foundation contient quatre pistes audio distinctes :
    • Piste 1 : Mix stéréo global équilibré (compatible avec tous les lecteurs multimédias du commerce et les réseaux sociaux).
    • Piste 2 : Le son du jeu pur (système sans ki-chat).
    • Piste 3 : Votre voix filtrée et débruitée.
    • Piste 4 : Les voix de vos coéquipiers dans le salon.
  4. Galerie intégrée : Retrouvez l'ensemble de vos clips dans l'onglet dédié de l'application, avec lecture immédiate, vignettes générées et raccourci pour ouvrir le dossier local dans l'Explorateur Windows.
  5. Une touche qui passe au-dessus du jeu : la combinaison est tenue par Windows (RegisterHotKey, le mécanisme d'Alt+Tab), pas lue par sondage — elle marche en plein écran, sous VALORANT et son anti-triche, sans lancer ki-chat en administrateur. Ctrl ou Maj tenus en plus (accroupi, en marche) ne la bloquent pas.
  6. Partager dans un salon (C2, 0.1.37) : clic droit sur un clip → le salon, une légende, et « avec les voix des copains » ou sans. Le clip monte par morceaux dans un stock à part (data/clips/, quota et durée de vie propres), le serveur en fabrique une copie à une seule piste son — le mélange, ou un mélange refait sans les copains ; leurs voix ne sortent jamais du dossier du clip — et poste le message en votre nom. Chez chacun, la carte vidéo, puis la visionneuse.
  7. L'atelier (C3) : « Modifier dans l'atelier… » — la coupe entre deux poignées sur une bande de vignettes, le format téléphone 9:16 en quatre mises en page (recadré, avec une position de fin pour suivre l'action ; resserré, presque tout, un peu déformé ; fond flou ; zoom), un titre, un curseur par piste, la cadence. Le serveur fabrique la vidéo d'après cette recette (jamais un filtre venu du client), puis : Enregistrer sous…, Partager dans un salon, ou Envoyer sur le téléphone par un QR code — un lien à jeton valable une heure, à scanner avec l'appareil photo, et la vidéo part sur TikTok ou Instagram depuis la feuille de partage du téléphone.

Visionneuse média & Téléversement par morceaux

(Livré avec le jalon C0 en version 0.1.35)

  • Affichage grand écran : Zoom fluide à la molette, déplacement panoramique, navigation chronologique d'un média à l'autre dans le salon (touches ← et →), bouton « Copier » et « Enregistrer sous ».
  • Support étendu : Photos, vidéos MP4/WebM/MKV, GIF et images WebP animées.
  • Normalisation serveur transparente : Les vidéos brutes issues de téléphones (formats verticaux HEVC d'iPhone, orientations EXIF) sont converties en tâche de fond par ffmpeg sur le serveur en H.264/AAC avec poster JPEG et méta-données.
  • Téléversement par morceaux (Chunking) : Les fichiers de plus de 25 Mo sont automatiquement découpés en blocs de 8 Mo (jusqu'à 512 Mo) avec reprise sur erreur, s'affranchissant des limites de requêtes des routeurs et reverse proxies.

Intégration VALORANT

Chantier conçu dans le respect strict des préconisations de Riot Games (PLAN-VALORANT.md) :

  • Statut en direct : Détection locale en lecture seule de la présence de votre propre jeu (sans injection ni scrutation de la mémoire). Affichage du mode, du score et de l'agent joué.
  • Les autres jeux : « joue à Rocket League » sous le pseudo, le jeu reconnu à sa fenêtre (plus de deux cents jeux connus, de Dofus à Elden Ring) sans rien lire dedans. Option « Dire aux membres à quoi je joue », cochée de base ; décochée, ça s'efface partout.
  • Fiches de carrière HenrikDev : Visualisation du rang compétitif, du pic de saison, du ratio V/D et de l'historique des parties récentes via l'API HenrikDev hébergée sur le serveur.
  • Statistiques enrichies (0.1.40) : la fiche se souvient des soixante derniers matchs et de cent points de RR ; les manches sont lues (ADR, KAST, premiers sangs, multi-kills, clutchs, poses/désamorçages) sans une requête de plus ; graphiques dessinés dans le client (courbe temporelle avec paliers, forme, agents, cartes, heures de jeu) ; MMR caché estimé d'après ses variations de RR. Toujours rien sur les neuf autres joueurs.
  • Fil de match automatique : Dès qu'une partie classée se termine, le serveur poste un résumé détaillé dans le salon textuel choisi (victoire/défaite, score, KDA individuel et gain/perte de RR). Si plusieurs membres du groupe étaient dans la même partie, leurs statistiques sont regroupées dans une seule annonce.
  • Le récap de la semaine : Le dimanche soir, le fil de jeu poste le bilan de la semaine écoulée — une ligne par membre qui a joué, du plus grand gain de RR au plus petit, avec son rang, ses matchs, victoires et défaites et son meilleur match.
  • Boutique du jour : Consultation sécurisée de vos 4 skins quotidiens en boutique directement depuis l'application ki-chat (lecture locale protégée de vos jetons Riot).

Bot musique de groupe

Membre virtuel autonome pour animer vos sessions de jeu (PLAN-MUSIQUE.md) :

  • Bannière rétractable : Placée au-dessus du fil de discussion, elle affiche le titre en cours, la pochette, le temps restant et une barre de progression cliquable.
  • Recherche intégrée : Saisissez un titre ou collez un lien YouTube / SoundCloud pour garnir la file de lecture partagée.
  • Playlists du groupe : Sauvegardez vos files d'écoute préférées et marquez vos morceaux d'une étoile pour les ajouter aux « Favoris ».
  • Zéro fardeau client : L'extraction et le réencodage Opus sont gérés à 100 % sur le serveur. Les clients reçoivent un flux audio chiffré similaire à la voix d'un utilisateur ordinaire, réglable individuellement en volume.

Porte web : inviter sans compte

  • Porte web (0.1.44) : Un membre qui peut créer des invitations ouvre une porte (salon1, 30 min à 6 h) depuis le bouton « Portes » de la barre latérale, et donne le lien — complet, https:// compris, par exemple https://ts.baws.fun:8080/invite (ou /s/invite), avec son QR code — à quelqu'un qui n'a ni compte ni l'application. La page (servie par le serveur, sans dépendance, mobile d'abord) reprend la fenêtre de ki-chat en plus léger — la colonne des salons à gauche, le fil avec ses avatars et ses pseudos aux mêmes couleurs que dans l'application, la colonne « En ligne » à droite (les membres qui lisent le salon et les invités, tenue à jour par le serveur), le vocal et ses occupants sous le salon vocal ; sur un téléphone, une colonne et deux tiroirs. Elle demande un nom ; les membres qui peuvent expulser voient « Kevin veut rejoindre par le web », acceptent ou refusent en un clic ; et l'invité lit et écrit, marqué « (web) », dans un salon textuel temporaire — rien d'autre : ni la liste des salons, ni celle des membres. Un membre peut aussi l'amener dans son salon vocal : la voix passe par la même WebSocket (Opus via WebCodecs), le serveur chiffre et déchiffre à sa place. Le salon est effacé à la fermeture, dix minutes sans invité ou six heures au plus. L'adresse dont les liens sont faits se règle dans Admin → Serveur → Adresse web publique (ts.baws.fun:8080 suffit, le https:// est ajouté) ; sans elle, le client prend l'adresse par laquelle il joint le serveur, en HTTPS sur le port 8080. Tout est borné (cinq portes, vingt invités, une demande par adresse, limiteur, sas, budget d'écriture) et journalisé dans l'audit. « Lui offrir ki-chat » poste le lien de téléchargement dans le salon et pousse à la page de l'invité — à lui seul, jamais dans le salon lu par les autres invités — un code d'invitation à usage unique de sept jours. Voir PLAN-PORTE.md.

Sécurité, Rôles & Modération

  • Authentification forte : Mots de passe salés et hachés via Argon2id. Protection contre les attaques par force brute avec délais exponentiels calculés avant tout calcul lourd de hachage.
  • Hiérarchie par rangs stricts : Une permission définit ce que l'on peut faire, le rang numérique définit sur qui. Un administrateur ne peut jamais modérer un autre administrateur de rang supérieur ou égal.
  • Invitations auditables : Génération de codes d'accès à usage unique, borné ou permanent. Chaque compte créé porte la trace du lien utilisé dans le journal d'audit (audit.jsonl).
  • Écritures atomiques : Toutes les modifications d'état (utilisateurs, canaux, permissions) sont écrites sur un fichier temporaire puis renommées de manière atomique (protection totale contre les corruptions en cas de coupure brutale du serveur).

Architecture & Développement

Organisation des crates

crates/
  protocol/     Types partagés : messages de contrôle JSON, paquets voix,
                en-têtes vidéo (KF) et audio jeu (KA), bornes de sécurité
  server/       ki-server : serveur QUIC (contrôle, SFU voix, SFU vidéo),
                serveur HTTPS (fichiers, morceaux d'upload, diagnostics),
                normalisation ffmpeg, moteur bot musique
  voice/        Moteur audio client : backend WASAPI natif (cpal en secours),
                gestionnaire Opus, jitter buffer adaptatif, annulation d'écho Speex,
                docteur audio, isolation du son du jeu
  video/        Capture d'écran WGC, réduction d'image, encodeurs NVENC et openh264,
                chaîne des clips tout-GPU (capture → processeur vidéo D3D → NVENC)
  media/        ki-media : couche Media Foundation Windows. Décodage Source Reader
                (NV12/PCM) et écriture MP4 par Sink Writer (clips multi-pistes)
  ki-opus/      Bindings et compilation de libopus 1.6.1 officielle (DRED, Deep PLC)
  ki-aec/       Annulation d'écho acoustique SpeexDSP MDF
  client-quic/  Gestion de la connexion cliente QUIC (contrôle fiable + datagrammes)
  client-cli/   Client léger en ligne de commande (chat et vocal)
  client-gui/   ki-chat : application graphique egui/eframe complète
  load/         ki-load : outil de test de charge simulant N clients virtuels réalistes

Transport QUIC (TLS 1.3)

Le protocole repose sur une unique connexion QUIC par client :

  • Flux bidirectionnel fiable : Transit des événements de contrôle (connexion, chat JSON, changements de rôles, présence).
  • Datagrammes non fiables chiffrés : Voix temps réel (paquets Opus chiffrés en XChaCha20-Poly1305).
  • Flux unidirectionnels par trame vidéo : Évite le blocage de tête de ligne entre images successives du partage d'écran.
  • Migration de connexion : Basculez d'une connexion Wi-Fi à un câble Ethernet (ou partage 4G/5G) sans déconnexion ni coupure vocale.

Mesurer la charge (ki-load & benchmarks)

Pour valider le comportement du serveur sans mobiliser 30 personnes réelles :

# Simuler 30 clients virtuels avec connexions réelles, authentification et voix chiffrée
cargo run --release -p ki-load -- 127.0.0.1 --clients 30 --invite "$KI_TOKEN" --secondes 60 --muets 20

# Benchmarks des chemins critiques audio et protocole
cargo bench -p ki-voice
cargo bench -p ki-protocol

Compiler & Publier une version

Prérequis de développement :

  • Rust stable (édition 2021).
  • Sous Windows : Visual Studio C++ Build Tools et CMake.
  • Outils optionnels : nasm pour optimiser l'encodage openh264.
# Lancer le serveur localement en développement
cargo run -p ki-server

# Lancer l'application de bureau
cargo run -p ki-client-gui

Procédure de publication (Release) :

  1. Incrémenter version = "0.x.y" dans le Cargo.toml racine et exécuter cargo check pour aligner Cargo.lock.
  2. Créer le tag Git correspondant et le pousser :
    git tag v0.x.y
    git push origin main
    git push origin v0.x.y
    
  3. Le workflow GitHub Actions release.yml valide les tests, compile les binaires Windows et macOS, signe cryptographiquement les exécutables en Ed25519 et publie la release GitHub.

Coûts réels

Licences logicielles : 0 €
Tout ce qui sert à construire et à faire tourner ki-chat est libre et gratuit — mais pas sous une seule licence :

  • ki-chat lui-même se déclare sous licence MIT (license = "MIT" dans Cargo.toml).
  • Ses dépendances Rust sont sous MIT, Apache-2.0, BSD, ISC, Zlib et apparentées ; la liste admise est tenue par deny.toml, que la CI vérifie à chaque poussée.
  • Les bibliothèques C compilées dedans : libopus et SpeexDSP (BSD), openh264 (BSD, compilé depuis ses sources — la licence de brevets H.264 de Cisco ne couvre que les binaires que Cisco distribue lui-même).
  • L'image Docker du serveur embarque un ffmpeg sous GPL (build « gpl » de BtbN), yt-dlp (Unlicense) et deno (MIT) : la redistribuer, c'est redistribuer ce ffmpeg, avec les obligations de la GPL (ses sources sont celles de BtbN/FFmpeg-Builds).

Les binaires publiés n'embarquent pas encore les notices des bibliothèques tierces.

Budget d'hébergement pour un groupe de ~30 joueurs :

  • VPS 2 vCPU / 4 Go de RAM (Hetzner, OVHcloud, Scaleway) : ~5 à 8 € / mois. Le serveur agissant en tant que relais SFU sans décompresser la voix ni réencoder la vidéo à la volée, la charge processeur reste minime.
  • Nom de domaine : ~10 € / an (facultatif, une adresse IP brute suffit amplement grâce aux certificats TLS auto-signés épinglés).
  • Hébergement à domicile : 0 € / mois sur une box fibre (redirection du port 9987/udp).

Feuille de route

Jalons livrés

  • M0–M2 — Fondations : protocole QUIC, relais vocal SFU, application graphique egui, salons, push-to-talk.

  • M3–M4 — Sécurité & Confort : comptes chiffrés Argon2id, voix chiffrée, débruitage RNNoise, partage de fichiers.

  • M4.5–M4.10 — Rôles, invitations traçables, égaliseur de volume par membre, limiteur doux, vumètres par locuteur, table de routage précalculée et débit adaptatif.

  • M5–M5.1 — Migration QUIC complète (TLS 1.3 natif) et adoption de libopus 1.6.1 avec DRED & Deep PLC.

  • M6–M6.5 — Refonte visuelle complète, carnet de multi-serveurs avec ping préalable, photos de profil synchronisées, mots de passe protégés par DPAPI/Trousseau.

  • M7–M8 — Packaging Windows autonome sans dépendance C++, mise à jour automatique signée Ed25519, journal d'audit immuable.

  • M9–M10 — Robustesse face aux jeux : gestionnaire WASAPI natif, Docteur audio, diagnostics partagés et reprise automatique après crash de pilote.

  • S1–S3 — Partage d'écran 60 fps : capture matérielle WGC, NVENC sans SDK, et isolation de la boucle audio du jeu.

  • M11–M12 — Overlay « qui parle » transparent sans injection ; support et paquet universel macOS.

  • V1–V4 (0.1.31 à 0.1.33) — Intégration VALORANT complète : statut en jeu en temps réel, fiches de carrière HenrikDev, fil de salon automatique et boutique quotidienne.

  • M1–M3 (0.1.34) — Bot musique haute fidélité : streaming direct sans pub, recherche YouTube/SoundCloud, playlists partagées et mémorisation d'état.

  • C0 (0.1.35) — Visionneuse photo & vidéo intégrée, décodeur Media Foundation natif, normalisation serveur ffmpeg et téléversement par morceaux de 8 Mo.

  • C1 (0.1.35) — Enregistreur de clips rétroactif (30 secondes à la touche Alt+F10), pistes audio séparées en MP4 et galerie de clips locale.

  • C2 (0.1.37) — Partage de clips dans les salons textuels : stock à part sur le serveur, une seule piste son (avec ou sans les voix des copains), message au nom du membre, carte vidéo — et la touche des clips tenue par Windows, qui passe au-dessus du jeu.

  • C3 (0.1.38) — Atelier de coupe et de recadrage au format téléphone (9:16, quatre mises en page, titre, mixage), export ffmpeg côté serveur d'après une recette validée, et envoi sur le téléphone par QR code.

  • Clips tout-GPU (0.1.47) — L'enregistreur ne ralentit plus la machine : capture, conversion et NVENC sur la carte sans passer par le processeur, NVENC sans CUDA, capture au rythme demandé, son sans gouffre mémoire ni dérive au fil des heures, écriture en arrière-plan, couleurs BT.709 déclarées, fenêtre de VALORANT enfin trouvée par l'automatique.

  • Son de stream (0.1.47) — Quand quelqu'un de son salon vocal lance un stream, une petite fanfare (« ta-ta-taa ») et l'overlay affiche « X diffuse son écran » par-dessus le jeu. Réglable dans ⚙ → Sons & notifications, remplaçable par un diffusion.wav.

  • Diffusion sur la carte (0.1.51) — Le partage d'écran ne passe plus par le processeur : capture, conversion et encodage restent sur la carte NVIDIA (comme les clips depuis 0.1.47), NVENC sans CUDA, la basse encodée à part sur la carte, la haute plus encodée du tout quand personne ne la regarde, et un aperçu en vignette relue sans attendre. Chez Pandora (GTX 1050 Ti, écran 3440×1440, VALORANT), l'ancien chemin plafonnait à 13-20 images par seconde. Les spectateurs journalisent leur décodage toutes les dix secondes.

  • Atelier juste à l'oreille (0.1.51) — Les curseurs de son de l'atelier s'entendent dans l'aperçu (il mêle lui-même le jeu, le micro et les copains à leurs niveaux, au lieu de jouer le mélange enregistré), et une coupe sans réencodage part de l'image clé pour le son comme pour l'image : fini le son en avance d'une seconde dans ki-chat et les lecteurs de Windows. L'atelier dit quand l'export commence un peu avant le repère.

  • Stream net et public visible (0.1.50) — Débit réglable jusqu'à 60 Mbit/s ; fini le flou à plusieurs spectateurs (le relais jugeait « saturé » quiconque recevait une trame clé et envoyait tout le monde en basse qualité) ; le nombre et les noms des spectateurs chez le streamer et dans le salon ; le débit entrant et sortant du serveur au tableau de bord.

  • Glisser en vocal (0.1.48) — Un occupant d'un salon vocal se glisse vers un autre salon et s'y retrouve (permission « Déplacer en vocal », rang au-dessus du sien ; se glisser soi-même, c'est y entrer). Et le clic droit → « Déplacer en vocal » ouvert depuis la barre des salons liste de nouveau les salons.

  • Présence (0.1.39) — « joue à … » sous le pseudo pour tous les jeux reconnus à leur fenêtre, VALORANT gardant sa partie détaillée.

  • Soundboard (0.1.39) — des sons à la touche entendus par le salon, mixés à la voix dans le moteur vocal.

  • Chat (0.1.39) — modifier ses messages (clic droit, ou flèche haut dans un champ vide), et glisser-déposer des fichiers sur la fenêtre.

  • Visionnage détaché (0.1.39) — le stream d'un copain dans sa propre fenêtre, à poser sur un second écran ou en plein écran (F11, double-clic, Échap).

  • Encodeur (0.1.39) — la diffusion descend seule en 30 i/s puis en 720p quand l'encodeur ne suit pas, et remonte prudemment.

  • Tableau de bord (0.1.39) — l'état du serveur en un écran dans l'administration : connectés, vocal, diffusions, stocks, musique, VALORANT, diagnostics.

  • V5 (0.1.40) — Statistiques enrichies : fiche accumulée, stats de manche, page du groupe en quatre onglets et graphiques au painter.

  • Clips (0.1.43) — Partage et atelier robustes sur un serveur lent : fabrique premier arrivé premier servi, coupe sans réencodage, fichiers servis en flux avec Range, source jamais servie, et un atelier qui dit toujours où il en est (file, pourcentage, chrono) et pourquoi ça échoue.

  • Non-lus et mentions (0.1.43) — Le serveur tient le « dernier lu » de chacun par salon (lus.json, écrit à retardement) et prévient les non-lecteurs d'un salon qu'il s'y écrit quelque chose (Nouveau) : pastille avec le nombre sur chaque salon textuel, à l'accent quand on y est nommé, compteur dans le titre de la fenêtre, séparateur « nouveaux messages » à l'entrée du salon, son de mention distinct et clignotement insistant de la barre des tâches. Réglage ⚙ → Sons & notifications : tout / mentions seulement / rien (les pastilles restent). Un client d'avant ne voit rien de neuf ; un client neuf face à un serveur d'avant ne compte que le salon ouvert.

  • Poke (0.1.43) — Clic droit sur un membre → « Poke » : un son et un clignotement chez lui, rien d'autre — pour appeler qui traîne dans les menus sans lui écrire. Le serveur refuse, motif en bannière, s'il est hors ligne, en vocal (il entend déjà), en partie (on ne le dérange pas) ou s'il a décoché ⚙ « Accepter les pokes » ; puis borne : un poke par paire toutes les cinq minutes, trois d'affilée par émetteur puis un toutes les 200 s, limites qui survivent aux reconnexions. Le bouton est grisé d'avance avec le motif, et masqué face à un serveur d'avant.

  • Zone de notification (0.1.43) — La croix ne quitte plus ki-chat : la fenêtre se réduit à côté de l'horloge (icône avec menu Ouvrir / Quitter, clic ou double-clic pour rouvrir) et tout continue — messages, sons, pokes, vocal, push-to-talk, reprise réseau — parce que la fenêtre reste une fenêtre que Windows repeint (cloakée par le compositeur et minimisée, bouton de la barre des tâches retiré ; jamais cachée, ce qui gèle update()). Réduit, l'icône porte une pastille et compte les non-lus dans son tooltip. Un garde-fou rouvre la fenêtre de force si elle ne peint plus pendant trois secondes, et une relance ou une mise à jour survenue réduit repart réduit (--reduit). Réglage ⚙ → Sons & notifications, coché par défaut, expliqué à la première fermeture. Une seule instance par session (0.1.44) : relancer ki-chat depuis l'icône du Bureau alors qu'il est réduit ramène la fenêtre existante au premier plan au lieu d'en ouvrir une seconde (--nouvelle-instance pour en vouloir vraiment une de plus).

  • Porte web (0.1.44) — Un lien vers un salon textuel temporaire pour des invités sans compte : page servie par le serveur (/s/salon1, WebSocket parlant le JSON du protocole, CSP sans unsafe-inline), demande d'accès approuvée en bannière par l'hôte ou qui peut expulser, invité marqué « (web) » dans une plage d'identifiants réservée, vocal par la même WebSocket avec chiffrement par le serveur, plafonds et audit, salon effacé à la fermeture, code d'invitation offert en un clic. Côté déploiement, une seconde écoute HTTPS (KI_TLS_CERT / KI_TLS_KEY, 443) sert le même routeur derrière un certificat public relu chaque heure, sans toucher au 8080 épinglé. Un client d'avant ne voit qu'un salon textuel de plus.

Perspectives & Prochains jalons

  • V8–V10 — VALORANT, saison 2 (PLAN-VALORANT-2.md) : savoir sur quel compte Riot chacun joue (plusieurs comptes par membre, journal des parties), un nouveau tableau de bord (accueil, soirée du groupe, profil en page, comparaison), et une carte tactique partagée en salon vocal dont les traits s'effacent au bout de 15 secondes.
  • C4 — Encodeur AMD/Intel, et une seule capture pour la diffusion et les clips (le chemin tout-GPU sert aux deux depuis 0.1.51).
  • Général — Résolution et cadence comme crans du débit adaptatif côté spectateur (le débit s'adapte déjà au spectateur qui ne suit pas, l'encodeur au streamer qui ne tient pas la cadence, et le son du jeu arrive en stéréo).