Installer

Votre serveur,en une commande.

ProtoFlix s’installe sur un Linux de la maison : un mini-PC, un NAS, une vieille tour. Il peut ensuite se mettre à jour tout seul, et revient en arrière si une version ne répond pas. La version 0.1 est en préparation : les paquets arrivent avec elle.

Votre système

Essayé · Le paquet .deb

$ sudo apt install ./protoflix_<version>_amd64.deb

Essayé sur un système vierge avec un vrai systemd. Le paquet apporte son FFmpeg, crée l’utilisateur protoflix et démarre le service.

Une commande.
Et c'est installé.

Pour Linux amd64 et arm64. Le serveur vous donne ensuite l'adresse où créer le compte administrateur.

La version 0.1 n'est pas encore publiée. Voici les commandes qu'elle utilisera ; ses paquets, leurs empreintes et l'image Docker arriveront ici. Suivre le journal des changements

sudo apt install ./protoflix_0.1.0_amd64.deb$

Essayé sur Debian 13 et Ubuntu 24.04. Le paquet apporte le FFmpeg de ProtoFlix et crée le service. Mise à jour : la même commande avec le nouveau paquet ; la base est sauvegardée, puis migrée. Le guide complet

1Créez le compte administrateurà l’adresse que le serveur vous donne, depuis n’importe quel navigateur du réseau.
2Ajoutez une bibliothèqueun dossier de films ou de séries lisible par l’utilisateur « protoflix ». Le serveur l’analyse et va chercher les métadonnées.
3Invitez vos prochesun lien d’invitation par personne, un profil chacun, des profils enfants si besoin.
4Branchez la TV et le téléphonesur Android TV, le serveur est trouvé tout seul sur le réseau ; on se connecte avec un code.

Mises à jour en un clic, ou seules la nuit. Le serveur cherche une version signée seulement si vous l'activez, attend la fin des lectures, et revient à la version d'avant, base comprise, si la nouvelle ne répond pas.

Le premier compte
demande un code.

Pour que personne d’autre sur le réseau ne prenne la place de l’administrateur, sa création demande un code que le serveur écrit dans son journal, nouveau à chaque démarrage. Elle n’est possible que depuis le réseau local.

Paquet ou archive

$ journalctl -u protoflix

Docker

$ docker compose -f deploy/docker/compose.yaml logs server

Puis ouvrez http://<adresse du serveur>:8097. Le code peut aussi être fixé d’avance avec PROTOFLIX_SETUP_TOKEN.

La carte graphique
travaille si elle sait.

Au démarrage, le serveur essaie chaque carte sur quelques images et ne garde que ce qui a marché. Si une conversion échoue en route, le processeur prend la suite.

Matériel	Par	État	Ce qu’on en sait
Graphismes intégrés Intel	`VAAPI`	Mesuré	Mesuré sur un UHD 750 : six conversions 4K vers 1080p tiennent le temps réel ensemble ; la limite est fixée à quatre. Les tons HDR se calculent sur la carte.
Graphismes AMD	`VAAPI`	Pas encore essayé	La même chaîne que pour Intel, avec le pilote mesa-va-drivers. Pas encore essayée sur une vraie Radeon.
Nvidia	`NVENC`	Pas encore essayé	Mesuré sur une GTX 1080, mais par le pilote Windows dans Docker : pas encore sur un vrai Linux.
Sans carte	`Processeur`	Mesuré	Toujours possible. C’est aussi le repli quand une carte échoue en cours de route.

Il faut le pilote VAAPI de la carte : intel-media-va-driver-non-free pour Intel, mesa-va-drivers pour AMD. Le paquet met déjà l’utilisateur du service dans le groupe render.

Les mises à jour
se font sans vous.

Désactivées par défaut. Activées, elles s’annoncent en un clic, ou s’installent seules entre 3 h et 6 h, jamais pendant une lecture. Seule une version signée par le projet s’installe, et le binaire, l’interface et la base reviennent en arrière si elle ne répond pas.

Simuler une version qui ne répond pas

Une version est publiéeLe serveur la cherche une fois par jour ; il attend qu’aucune lecture ne tourne.
Sa signature est vérifiéeEd25519, par un service séparé, avec les clés du binaire déjà installé.
La base est sauvegardéeUne copie vérifiée. Si la sauvegarde échoue, rien n’est migré.
La base est migréeUne transaction par migration : une migration qui échoue est annulée.
Le serveur redémarreSur la nouvelle version.
Il doit répondreDans ses cinq minutes. Sinon, binaire, interface et base reviennent à la version d’avant.

Ce qui reste chez vous
et où.

Rien d’autre à installerPas de serveur de base de données, pas de Redis, pas de moteur de recherche : la base est un fichier SQLite, dans le serveur.
/var/lib/protoflixLa base, la clé des secrets et les sauvegardes. Sur un disque local : le serveur refuse une base sur un partage SMB ou NFS.
/etc/protoflix/protoflix.envVos réglages, gardés à chaque mise à jour. Le port est 8097, pour tourner à côté de Jellyfin.
Vos films, où ils sontLisibles par l’utilisateur protoflix. ProtoFlix ne les déplace pas et ne les renomme pas.

Retirer ProtoFlix : sudo apt remove protoflix garde la base ; sudo apt purge protoflix efface aussi la base et les réglages. Vos films ne sont jamais touchés.