Installation
Installez KROMA sur tous vos écrans.
On installe le serveur une seule fois. Ensuite chaque client, TV, ordinateur, mobile, navigateur, pointe vers lui et retient son adresse.
Dernière version
Installez le serveur
Un seul serveur Rust, sur un NAS, dans Docker, ou compilé à la main. Il sert l’API, l’app web et le flux vidéo sur le port 4040. La vidéo n’est jamais transcodée.
Docker / Docker Compose
RecommandéL’image est multi-architecture (linux/amd64 + linux/arm64) : elle tourne aussi bien sur un x86 que sur un Raspberry Pi 4/5 en OS 64 bits. Enregistrez ce fichier puis lancez la pile.
Une version publiée
ghcr.io/kromatv/kroma:0.1.38L’image compilée pour ce tag. Elle ne changera jamais sous vos pieds.
Canari
ghcr.io/kromatv/kroma:latestRecompilée à chaque push sur main. Un pull récupère l’état courant du code. Publique, multi-architecture, sans jeton.
services:
kroma:
image: ghcr.io/kromatv/kroma:latest
restart: unless-stopped
ports:
- "4040:4040"
environment:
# Library roots INSIDE the container (must match the bind-mount below).
KROMA_MEDIA_DIRS: /media
volumes:
- kroma-data:/data
- /volume1/video:/media
volumes:
kroma-data:docker compose up -dMédiasKROMA_MEDIA_DIRS pointe vers vos médias dans le conteneur ; montez le dossier en lecture-écriture si vous utilisez les requêtes / téléchargements intégrés.
Synology (.spk)
Le paquet est auto-signé, pas certifié Synology : il faut l’autoriser une fois.
- 1Centre de paquets → Paramètres → Niveau de confiance : autorisez N’importe quel éditeur.
- 2Centre de paquets → Installation manuelle, choisissez le .spk, suivez l’assistant.
- 3Ouvrez KROMA ; configurez les dossiers médias dans sa console d’administration.
Depuis les sources (cargo)
Un seul binaire Rust : compilez-le vous-même. SQLite et TLS sont embarqués ; ffmpeg/ffprobe restent requis pour les métadonnées et l’audio HLS.
# Rust ≥ 1.86 + ffprobe. From the repo:
cd server
KROMA_MEDIA_DIRS=/mnt/media cargo run --releaseInstallez les apps
Récupérez le bon paquet dans les GitHub Releases (un tag vX.Y.Z porte tous les artefacts). Les téléviseurs demandent d’activer le mode développeur une fois ; tout le reste s’installe directement. Puis le client demande l’adresse du serveur au premier lancement. GitHub Releases →
Téléviseurs
Sideload depuis un ordinateur du même réseau. Le mode développeur s’active une fois.
Étapes détailléesSamsung (Tizen)
fdfddfe6a58a…Mode développeurPanneau Apps → tapez 1 2 3 4 5, activez-le et saisissez l’IP de votre ordinateur. Le .wgt est déjà signé, aucun certificat requis, juste le CLI de Tizen Studio.
Installer depuis un terminal
sdb connect 192.168.1.50
tizen install -n KROMA-tizen-*.wgt -t <device-id>LG (webOS 4.0+)
5aff5697bdef…Mode développeurInstallez l’app Developer Mode (compte LG gratuit), activez Dev Mode puis Key Server. La session dure 50 h, à prolonger dans l’app.
Installer depuis un terminal
bun add -g @webos-tools/cli
ares-install tv.kroma.webos_*_all.ipk -d tvAndroid TV / Google TV / Chromecast
dc3c99d5fc1b…Options développeurParamètres → À propos → build Android TV OS : cliquez 7 fois, puis activez le débogage réseau. Sans ordinateur, l’app Downloader installe l’.apk depuis une URL.
Installer depuis un terminal
adb connect 192.168.1.60:5555
adb install -r KROMA-androidtv.apkOrdinateurs
Des installeurs classiques. Les apps de bureau se mettent à jour toutes seules ensuite.
Étapes détailléesmacOS
bbc124ee97ee…Windows
938407d677fa…787c213a708b…SmartScreenInstalleur non signé : « Windows a protégé votre PC » → Informations complémentaires → Exécuter quand même. Mises à jour silencieuses ensuite.
Linux (bureau)
92575a1636b2…6a34423d06c8…Vidéompv est embarqué (le sidecar kroma-mpv pilote le décodage matériel), rien à installer.
Le rendre exécutable
chmod +x KROMA_*.AppImage && ./KROMA_*.AppImage
# .deb : sudo apt install ./KROMA_*.debSteam Deck
92575a1636b2…L’ajouter à Steam
- 1Copiez KROMA_*.AppImage sur le Deck et chmod +x (Mode Bureau).
- 2Steam → Ajouter un jeu non-Steam → Parcourir, puis choisissez l’AppImage.
- 3Lancez en Mode Jeu, disposition manette sur Gamepad (croix = focus, A = OK, B = retour).
Mobile
Les apps téléphone sont en cours de finition, distribuées via les canaux de test.
Étapes détailléesiPhone / iPad
BêtaAndroid
BêtaNAS & navigateur
Là où le serveur vit déjà, il n’y a le plus souvent rien de plus à installer.
Étapes détailléesNavigateur web
Rien à installerLe serveur sert lui-même l’app web. Ouvrez son adresse dans n’importe quel navigateur, ou laissez la découverte mDNS le trouver sur le réseau.
http://nas.local:4040Synology
d79cb8a3a980…Mises à jour automatiquesLa meilleure voie sur un NAS : ajoutez KROMA comme source de paquets dans le Centre de paquets. Le serveur s’installe puis se met à jour tout seul, sans re-télécharger un .spk à chaque version.
Ajouter la source de paquets
- 1Centre de paquets → Paramètres → Sources de paquets → Ajouter.
- 2Collez l’URL de la source ci-dessous, puis validez le niveau de confiance « N’importe quel éditeur » (le paquet est auto-signé).
- 3Installez KROMA depuis la source ; les mises à jour arrivent ensuite automatiquement.
https://packages.kroma.tvPréférez une installation manuelle ? Téléchargez le .spk depuis les releases et passez par Centre de paquets → Installation manuelle. Voir les releases →
Un paquet qui refuse de s’installer ? Le plus souvent une signature qui a changé : désinstallez l’ancienne version, puis réinstallez.