![Static Badge](https://img.shields.io/badge/freebox-revolution-black) ![Static Badge](https://img.shields.io/badge/jellyfin-purple?logo=jellyfin&logoColor=white) # Freebox Jellyfin Cette application permet d'utiliser jellyfin sur la freebox. # Configurer un environment de travail [Documentation pour le SDK de la freebox](https://dev.freebox.fr/sdk/player.html). Pour Windows, [voir ce billet sur Github](https://github.com/fbx/freebox-qtcreator-plugin/issues/8). Les outils (aperçu, vérification, paquet, déploiement) sont regroupés dans le module Python `freebox_jellyfin` (`src/`), géré avec [uv](https://docs.astral.sh/uv/) : ```bash uv sync # crée .venv (Python 3.14) et installe la commande freebox-jellyfin uv run freebox-jellyfin # liste les commandes ``` ## Aperçu sur PC (Linux) Sans Freebox, l'application tourne avec `qmlscene` (Qt 5) et la bibliothèque [libfbxqml](https://github.com/fbx/libfbxqml) : ```bash sudo apt install qmlscene qml-module-qtmultimedia qtdeclarative5-dev-tools git clone https://github.com/fbx/libfbxqml.git ../libfbxqml uv run freebox-jellyfin preview # fenêtre 1280x720 uv run freebox-jellyfin preview --fullscreen # plein écran, comme sur la box uv run freebox-jellyfin check # chargement en HTTP comme le Player, échoue sur tout avertissement Qt ``` ## Tester sur la Freebox Activer le mode développeur du Player (menu Réglages, avec la télécommande), puis : ```bash uv run freebox-jellyfin deploy # trouve le Player sur le réseau et lance l'app uv run freebox-jellyfin deploy --box 192.168.0.21 # ou en donnant son adresse uv run freebox-jellyfin deploy --server media.example.com # l'app ajoute ce serveur au démarrage uv run freebox-jellyfin deploy --server media.example.com --user alice:motdepasse bob ``` En mode développement, la box n'enregistre aucune donnée de l'application. Pour éviter de tout ressaisir à chaque test : - `--server ` : le serveur est ajouté automatiquement à la liste ; - `--user [:]` (répétable) : le compte apparaît sur « Qui regarde ? », même si le serveur masque ses comptes. Avec un mot de passe, la connexion se fait en un clic ; sans, l'écran de connexion s'ouvre avec le nom pré-rempli. Le mot de passe n'apparaît pas dans les logs, mais il transite en clair sur le réseau local. La commande sert les fichiers du projet au Player et affiche les logs de l'application. Il doit rester ouvert pendant le test (Ctrl+C pour arrêter). ## Publier sur le FreeStore ```bash uv run freebox-jellyfin package # crée dist/com.stilobique.jellyfin-.tar.gz ``` Pour une nouvelle version, modifier `version` dans `manifest.json` **et** `clientVersion` dans `Core/Session.qml` (la commande refuse de créer le paquet si elles diffèrent). La commande reproduit « Make FreeStore Package » du plugin QtCreator : il vérifie `manifest.json` et la syntaxe QML/JS (`qmllint`), puis crée l'archive à téléverser sur la console [FreeFactory](http://factory.free.fr) (compte développeur requis, validation par Free avant publication). ## Intégration continue Le workflow Gitea Actions `.gitea/workflows/ci.yml` : - à chaque push / pull request : vérifie le manifest et la syntaxe QML/JS, charge l'application en HTTP comme le Player (`freebox-jellyfin check`) et publie le paquet en artefact ; - sur un tag `vX.Y.Z` (égal à la version du manifest) : crée une release Gitea avec le paquet FreeStore en pièce jointe. ```bash git tag v0.1.0 && git push origin v0.1.0 ``` Le téléversement sur la console FreeFactory reste manuel.