SPB Git

Repository Public

README.md 13.7 KB 288 lines markdown

1<div align="center">23# 🎬 jellyfin-node45**Serveur Jellyfin du cluster MacLustr — trois scripts shell idempotents pour installer, lancer et configurer un Jellyfin portable sur macOS arm64, publié derrière la session de SP TV.**67![Jellyfin](https://img.shields.io/badge/Jellyfin-12.4-00A4DC?style=for-the-badge&logo=jellyfin&logoColor=white)8![Plateforme](https://img.shields.io/badge/macOS-arm64-000000?style=for-the-badge&logo=apple&logoColor=white)9![Licence](https://img.shields.io/badge/licence-tous%20droits%20r%C3%A9serv%C3%A9s-lightgrey?style=for-the-badge)1011![Bash](https://img.shields.io/badge/Bash-scripts-4EAA25?style=flat-square&logo=gnubash&logoColor=white)12![Python](https://img.shields.io/badge/Python%203-analyse%20JSON-3776AB?style=flat-square&logo=python&logoColor=white)13![curl](https://img.shields.io/badge/curl-API%20Jellyfin-073551?style=flat-square&logo=curl&logoColor=white)14![FFmpeg](https://img.shields.io/badge/FFmpeg-Homebrew-007808?style=flat-square&logo=ffmpeg&logoColor=white)15![VideoToolbox](https://img.shields.io/badge/encodage-VideoToolbox-999999?style=flat-square&logo=apple&logoColor=white)16![PM2](https://img.shields.io/badge/PM2-jellyfin-2B037A?style=flat-square&logo=pm2&logoColor=white)1718[![commits](https://git.spboucher.ai/badge/jellyfin/commits.svg?style=flat-square)](https://git.spboucher.ai/jellyfin/commits)19[![dernier commit](https://git.spboucher.ai/badge/jellyfin/last-commit.svg?style=flat-square)](https://git.spboucher.ai/jellyfin/commits)20[![activité](https://git.spboucher.ai/badge/jellyfin/activity.svg?style=flat-square)](https://git.spboucher.ai/jellyfin/insights)21[![langage](https://git.spboucher.ai/badge/jellyfin/language.svg?style=flat-square)](https://git.spboucher.ai/jellyfin)22[![langages](https://git.spboucher.ai/badge/jellyfin/languages.svg?style=flat-square)](https://git.spboucher.ai/jellyfin/insights)23[![taille](https://git.spboucher.ai/badge/jellyfin/size.svg?style=flat-square)](https://git.spboucher.ai/jellyfin)24[![branches](https://git.spboucher.ai/badge/jellyfin/branches.svg?style=flat-square)](https://git.spboucher.ai/jellyfin/branches)25[![tags](https://git.spboucher.ai/badge/jellyfin/tags.svg?style=flat-square)](https://git.spboucher.ai/jellyfin/tags)26[![clones](https://git.spboucher.ai/badge/jellyfin/clones.svg?style=flat-square)](https://git.spboucher.ai/jellyfin)2728![scripts](https://img.shields.io/badge/scripts-3-blue?style=flat-square)29![lignes de shell](https://img.shields.io/badge/lignes%20de%20shell-64-blue?style=flat-square)30![types de bibliothèques](https://img.shields.io/badge/types%20de%20biblioth%C3%A8ques-3-blue?style=flat-square)31![dépendances npm](https://img.shields.io/badge/d%C3%A9pendances%20npm-0-brightgreen?style=flat-square)3233![nœud](https://img.shields.io/badge/n%C5%93ud-m4mn-8A2BE2?style=flat-square)34![port](https://img.shields.io/badge/port-8096-informational?style=flat-square)35![URL de base](https://img.shields.io/badge/URL%20de%20base-%2Fjellyfin-informational?style=flat-square)36![déploiement](https://img.shields.io/badge/d%C3%A9ploiement-mld-orange?style=flat-square)37![domaine](https://img.shields.io/badge/domaine%20public-aucun-lightgrey?style=flat-square)3839</div>4041---4243## Sommaire4445- [Présentation](#-présentation)46- [Ce que fait le dépôt](#-ce-que-fait-le-dépôt)47- [Architecture](#-architecture)48- [Pile technique](#-pile-technique)49- [Arborescence](#-arborescence)50- [Emplacements sur le nœud](#-emplacements-sur-le-nœud)51- [Installation et démarrage](#-installation-et-démarrage)52- [Configuration](#-configuration)53- [Scripts en détail](#-scripts-en-détail)54- [Accès](#-accès)55- [Bibliothèques](#-bibliothèques)56- [Déploiement (MacLustr, `mld`)](#-déploiement-maclustr-mld)57- [Mise à niveau](#-mise-à-niveau)58- [Sauvegarde](#-sauvegarde)59- [Sécurité](#-sécurité)60- [État et limites](#-état-et-limites)61- [Auteur et licence](#-auteur-et-licence)6263---6465## 📺 Présentation6667Serveur Jellyfin du cluster MacLustr, déployé par `mld` (app `jellyfin`) sur **m4mn**, port **8096**, URL de base68`/jellyfin`.6970Le dépôt ne contient **pas** Jellyfin lui-même : il contient la recette pour l'installer et l'exploiter sur un Mac Apple71Silicon, en trois scripts shell sans dépendance autre que `curl`, `tar`, `python3` et `ffmpeg`. Il sert de bibliothèque72multimédia à [SP TV](https://git.spboucher.ai/sp-tv) (`https://tv.spboucher.ai`), qui la lit par son connecteur Jellyfin73(Admin → Sources).7475## ✨ Ce que fait le dépôt7677- **Binaire** : build portable officiel macOS arm64, hors du dépôt, dans `~/opt/jellyfin/<version>` (`install.sh`).78- **Données, configuration, journaux** : `~/data/jellyfin/`. Mot de passe administrateur : `~/.config/jellyfin/admin-password`.79- **Processus PM2** : `jellyfin` (`start.sh`). ffmpeg de Homebrew, encodage matériel VideoToolbox.80- **Publication sous un préfixe** : Jellyfin est servi sous `/jellyfin` (fichier `network.xml` écrit par `install.sh`) afin81  de pouvoir se placer derrière un autre site — SP TV — sur le même nom d'hôte.82- **Premier démarrage automatisé** (`setup.sh`) par l'API de Jellyfin : compte administrateur, bibliothèques, encodage83  matériel, langue et pays des métadonnées (français, Canada).84- **Idempotence** : chaque script peut être relancé sans effet de bord (version déjà installée conservée, assistant déjà85  terminé laissé tel quel, bibliothèques existantes non dupliquées).8687## 🏗 Architecture8889```mermaid90flowchart LR91    subgraph Internet92        U[Appareil<br/>navigateur / téléviseur]93    end94    subgraph Passerelle["Passerelle MacLustr Tunnel"]95        C[Caddy HTTPS]96    end97    subgraph m4mn["Nœud m4mn"]98        TV["SP TV · Next.js<br/>port 8670<br/>contrôle de session"]99        JF["Jellyfin · PM2 « jellyfin »<br/>port 8096 · /jellyfin"]100        FF[ffmpeg Homebrew<br/>VideoToolbox]101        D[("~/data/jellyfin<br/>data · cache · config · log")]102        M[("Dossiers de médias")]103    end104    LAN[Réseau de la maison] -->|"http · /jellyfin/web/"| JF105    U -->|"https://tv.spboucher.ai/jellyfin/"| C --> TV106    TV -->|"réécriture JELLYFIN_PROXY"| JF107    TV -.->|"connecteur Jellyfin (API)"| JF108    JF --> FF109    JF --> D110    JF --> M111```112113Jellyfin n'a **aucun nom de domaine propre**. De l'extérieur, il n'est joignable qu'à travers SP TV, donc en HTTPS et114seulement avec une session SP TV ouverte.115116## 🧰 Pile technique117118| Rôle | Technologie | Version / remarque |119|---|---|---|120| Serveur multimédia | Jellyfin, build portable officiel macOS arm64 | `12.4` par défaut (`JELLYFIN_VERSION` dans `install.sh`) |121| Scripts | Bash (`set -euo pipefail`) | 3 scripts, 64 lignes |122| Appels d'API | `curl` | API REST de Jellyfin |123| Analyse JSON | `python3 -I` (bibliothèque standard) | aucune dépendance installée |124| Transcodage | `ffmpeg` de Homebrew | accélération matérielle Apple VideoToolbox |125| Gestionnaire de processus | PM2 | processus `jellyfin` |126| Orchestration | `mld` (maclustr-dispatch) | app `jellyfin`, `install.sh` en crochet `post_sync` |127128## 🗂 Arborescence129130```text131jellyfin/132├── install.sh    # télécharge et installe Jellyfin hors du dépôt, prépare la configuration réseau (26 lignes)133├── start.sh      # lance le serveur au premier plan ; PM2 le maintient en vie (6 lignes)134├── setup.sh      # premier démarrage par l'API : compte, bibliothèques, encodage matériel (32 lignes)135├── README.md136└── .gitignore137```138139## 📍 Emplacements sur le nœud140141| Chemin | Contenu |142|---|---|143| `~/apps/jellyfin` | ce dépôt (clone git déployé par `mld`) |144| `~/opt/jellyfin/<version>` | binaire portable de Jellyfin, un dossier par version |145| `~/opt/jellyfin/current` | lien symbolique vers la version active |146| `~/data/jellyfin/data` | base et données de Jellyfin |147| `~/data/jellyfin/cache` | cache |148| `~/data/jellyfin/config` | configuration (dont `network.xml`) |149| `~/data/jellyfin/log` | journaux |150| `~/.config/jellyfin/admin-password` | mot de passe administrateur (hors dépôt) |151152`~/data/jellyfin` est créé en mode `700`.153154## 🚀 Installation et démarrage155156```bash157# 1. Installer le binaire et préparer la configuration (idempotent)158./install.sh159160# 2. Lancer le serveur sous PM2161pm2 start ./start.sh --name jellyfin162163# 3. Premier démarrage : compte administrateur, bibliothèques, encodage matériel164./setup.sh sp ~/.config/jellyfin/admin-password "Films:movies:/chemin/vers/films" "Séries:tvshows:/chemin/vers/series"165```166167Prérequis : macOS sur Apple Silicon, `curl`, `tar` (avec prise en charge de `xz`), `python3`, `ffmpeg` (Homebrew), PM2.168169## ⚙️ Configuration170171| Variable | Script | Rôle | Défaut |172|---|---|---|---|173| `JELLYFIN_VERSION` | `install.sh` | version de Jellyfin à installer | `12.4` |174| `JELLYFIN_URL` | `setup.sh` | adresse de l'API de Jellyfin utilisée par la configuration | `http://127.0.0.1:8096/jellyfin` |175176Côté SP TV, la variable `JELLYFIN_PROXY` (lue au `next build` de SP TV) publie ce serveur sous `/jellyfin` du site.177178## 🔧 Scripts en détail179180### `install.sh`181182Installe le serveur Jellyfin (build portable officiel macOS arm64) hors du dossier de l'application et prépare sa183configuration. Exécuté par `mld deploy` (crochet `post_sync`) et utilisable à la main.1841851. crée `~/opt/jellyfin` et `~/data/jellyfin/{data,cache,config,log}` ;1862. si la version demandée n'est pas déjà présente, télécharge l'archive `jellyfin_<version>-arm64.tar.xz` depuis187   `repo.jellyfin.org` et l'extrait dans `~/opt/jellyfin/<version>` ;1883. pointe le lien `~/opt/jellyfin/current` sur cette version ;1894. écrit `config/network.xml` avec `<BaseUrl>/jellyfin</BaseUrl>` s'il n'existe pas encore.190191### `start.sh`192193Lance Jellyfin au premier plan (`exec`), avec `--datadir`, `--cachedir`, `--configdir`, `--logdir` sous `~/data/jellyfin`194et `--ffmpeg` pointant sur le `ffmpeg` trouvé dans le `PATH` (à défaut `/opt/homebrew/bin/ffmpeg`).195196### `setup.sh`197198```text199setup.sh <utilisateur-admin> <fichier-mot-de-passe> [nom:type:chemin ...]      type = movies | tvshows | homevideos200```201202| Étape | Appel à l'API de Jellyfin | Effet |203|---|---|---|204| État de l'assistant | `GET /System/Info/Public` | un assistant déjà terminé est laissé tel quel |205| Langue et pays | `POST /Startup/Configuration` | interface en français, métadonnées `fr` / `CA` |206| Compte administrateur | `GET` puis `POST /Startup/User` | compte créé avec le mot de passe lu dans le fichier |207| Accès distant | `POST /Startup/RemoteAccess` | accès distant activé, pas de redirection de port automatique |208| Fin de l'assistant | `POST /Startup/Complete` | — |209| Connexion | `POST /Users/AuthenticateByName` | jeton de session temporaire |210| Bibliothèques | `GET` / `POST /Library/VirtualFolders` | une bibliothèque par argument ; existante ou dossier absent : ignorée avec un message |211| Encodage | `GET` / `POST /System/Configuration/encoding` | `HardwareAccelerationType = videotoolbox`, encodage matériel activé |212| Déconnexion | `POST /Sessions/Logout` | le jeton temporaire est fermé |213214Le mot de passe est lu depuis un fichier et transmis à `curl` par l'entrée standard (`-d @-`) : il n'apparaît pas dans la215liste des processus.216217## 🌐 Accès218219- depuis SP TV, partout : `https://tv.spboucher.ai/jellyfin/` — publié par SP TV lui-même (variable `JELLYFIN_PROXY` de220  SP TV), donc en HTTPS et **seulement avec une session SP TV ouverte** ;221- à la maison, interface d'administration : `http://<ip-de-m4mn>:8096/jellyfin/web/`.222223SP TV lit cette bibliothèque par son connecteur Jellyfin (Admin → Sources).224225## 📚 Bibliothèques226227Les bibliothèques sont créées par `setup.sh` (voir la commande ci-dessus). Pour en ajouter : interface de Jellyfin, ou228229```bash230./setup.sh sp ~/.config/jellyfin/admin-password "Nom:movies:/chemin"231```232233| Type | Contenu |234|---|---|235| `movies` | films |236| `tvshows` | séries |237| `homevideos` | vidéos personnelles |238239Chaque bibliothèque est créée avec les métadonnées en français (pays `CA`) et une analyse immédiate (`refreshLibrary=true`).240241## 🚢 Déploiement (MacLustr, `mld`)242243| Élément | Valeur |244|---|---|245| App `mld` | `jellyfin` |246| Nœud | **m4mn**, dossier `~/apps/jellyfin` (clone git, `origin` = spbgit `jellyfin.git`) |247| Port | **8096**, URL de base `/jellyfin` |248| Processus PM2 | `jellyfin` (`start.sh`) |249| Crochet de déploiement | `install.sh` (`post_sync`) |250| Domaine public | aucun — publié sous `https://tv.spboucher.ai/jellyfin/` par SP TV |251252```bash253mld deploy jellyfin --node m4mn     # synchronisation, install.sh, PM2254mld status --live | grep jellyfin   # état vu de la passerelle255```256257## ⬆️ Mise à niveau258259```bash260JELLYFIN_VERSION=x.y ./install.sh && pm2 restart jellyfin261```262263L'ancienne version reste dans `~/opt/jellyfin/<ancienne-version>` ; seul le lien `current` change.264265## 💾 Sauvegarde266267À sauvegarder : `~/data/jellyfin/data` et `~/data/jellyfin/config` (**non sauvegardés automatiquement à ce jour**).268269## 🔒 Sécurité270271- Aucun secret dans le dépôt : le mot de passe administrateur vit dans `~/.config/jellyfin/admin-password`, hors du clone.272- Pas d'exposition directe sur Internet : l'accès extérieur passe par SP TV, en HTTPS, derrière sa session.273- `~/data/jellyfin` en mode `700`.274- `python3 -I` (mode isolé) pour analyser les réponses JSON ; `set -euo pipefail` dans les trois scripts.275276## 🧭 État et limites277278- En service sur m4mn (dépôt adopté comme source de vérité le 2026-11-17, « remote-first »).279- Sauvegarde automatique des données : à faire.280- Pas de tests automatisés (dépôt de trois scripts).281282## 👤 Auteur et licence283284**Simon-Pierre Boucher** — [contact@spboucher.ai](mailto:contact@spboucher.ai) · forge : [git.spboucher.ai](https://git.spboucher.ai)285286Scripts de ce dépôt : tous droits réservés. Jellyfin est un logiciel libre distribué séparément par son projet287([jellyfin.org](https://jellyfin.org)) ; il n'est pas inclus dans ce dépôt.288
Files main
Menu

Theme