Refactoring, create a src folders with the python toolchain
This commit is contained in:
1 parent
2790d92a60
commit
33e4fe0c4e
19 files changed
+246
-122
No files matched your search
@@ -7,48 +7,57 @@
|
||||
Cette application permet d'utiliser jellyfin sur la freebox.
|
||||
|
||||
|
||||
# Configurer un environement de travail
|
||||
# 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
|
||||
tools/run-local.sh # fenêtre 1280x720
|
||||
tools/run-local.sh --fullscreen # plein écran, comme sur la box
|
||||
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
|
||||
tools/deploy.py # trouve le Player sur le réseau et lance l'app
|
||||
tools/deploy.py --box 192.168.0.21 # ou en donnant son adresse
|
||||
tools/deploy.py --server media.example.com # l'app ajoute ce serveur au démarrage
|
||||
tools/deploy.py --server media.example.com --user alice:motdepasse --user bob
|
||||
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 <adresse>` : le serveur est ajouté automatiquement à la liste ;
|
||||
- `--user <nom>[:<mot de passe>]` (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.
|
||||
|
||||
Le script 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).
|
||||
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
|
||||
tools/package.py # crée dist/com.stilobique.jellyfin-<version>.tar.gz
|
||||
uv run freebox-jellyfin package # crée dist/com.stilobique.jellyfin-<version>.tar.gz
|
||||
```
|
||||
|
||||
Pour une nouvelle version, modifier `version` dans `manifest.json` **et** `clientVersion` dans `Core/Session.qml` (le script refuse de créer le paquet si elles diffèrent).
|
||||
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).
|
||||
|
||||
Le script 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).
|
||||
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 (`tools/check-load.sh`) et publie le paquet en artefact ;
|
||||
- à 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
|
||||
|
||||
Reference in new issue
Block a user