PlexMetaForge : prise en main complète

Gère les plugins Plex historiques (.bundle), injecte des métadonnées (NFO, affiches, API Plex) et installe depuis un catalogue de 60 agents vérifiés.

Visite guidée

Les écrans de PlexMetaForge, avec leurs zones numérotées et expliquées.

Plugins : vos agents Plex installés

L'écran d'accueil liste les plugins (agents de métadonnées) installés sur votre serveur Plex Media Server.

1. Le menu — Plugins, Catalogue de plugins à installer, éditeur de Métadonnées, Base de données Plex, éditeur de Code et Paramètres.
2. Ce qui a été détecté — Le dossier Plug-ins de Plex et sa base de données, trouvés automatiquement. Un point vert : trouvé ; rouge : absent (Plex n'est pas installé sur ce PC, ou ailleurs).
3. Exporter — Sauvegarde tous vos plugins d'un coup dans Téléchargements\PlexMetaForge_Exports.
4. Mes plugins ou en créer un — Basculez entre la liste de vos plugins et l'assistant de création.
5. Filtrer — Tapez quelques lettres pour retrouver un plugin dans une longue liste.
6. Chaque plugin — Nom, état (point vert = actif) et langage. À droite : télécharger, Éditer son code, Désactiver sans le supprimer, ou Supprimer.
7. Actualiser — Relit le dossier de Plex après une installation faite en dehors de l'application.

Créer un plugin en quelques clics

1. Modèle ou sur mesure — Partez d'un modèle prêt à l'emploi ou écrivez un plugin entièrement personnalisé.
2. Les modèles — Vierge, Films, Séries TV, Musique, Anime / Manga ou Universel, qui gère tout à la fois avec détection automatique.
3. Ce que fait le modèle — Le résumé du modèle choisi, avec ce dont il a besoin (ici une clé TMDB).
4. Nom du plugin — Le nom qui apparaîtra dans Plex (par exemple CinemaFR).
5. Clé TMDB — Facultative au départ : le lien « obtenir » explique comment créer gratuitement votre clé The Movie Database.
6. Générer — Crée le plugin et l'installe directement dans le dossier de Plex ; la liste des fichiers générés s'affiche dessous.

Le catalogue : 59 plugins à installer

1. Les catégories — Métadonnées (films, séries, anime, musique, concerts, livres audio, podcasts, BD, jeux vidéo, sport), Sous-titres et Outils, avec le nombre de plugins de chacune.
2. Recherche — Cherchez un plugin par nom ou par mot-clé.
3. Installation groupée — Cochez plusieurs plugins (ou « Tout sélectionner ») pour les installer en une fois.
4. La fiche d'un plugin — Nom, badge « Vérifié », auteur, popularité, licence, description et mots-clés : tout pour choisir en connaissance de cause.
5. Installer — Installe le plugin dans Plex en un clic ; GitHub ouvre son code source.

Corriger les métadonnées d'un film

Quand Plex se trompe de film ou n'a pas d'affiche, vous saisissez ou corrigez les informations à la main.

1. Rechercher dans Plex — Tapez le titre du média pour retrouver sa fiche dans votre bibliothèque.
2. Les informations — Titre, année, synopsis, identifiants TMDB et IMDb, adresses de l'affiche et du fond, accroche, studio, note sur 10.
3. Le dossier du média — Le dossier du film sur le disque (obligatoire) : c'est là que les informations sont écrites.
4. Injecter — Enregistre les métadonnées pour que Plex les reprenne à la prochaine actualisation.
5. Configurer Plex — Raccourci vers les réglages de connexion au serveur.

L'éditeur de code

Pour aller plus loin : choisissez un plugin dans la liste (bouton Éditer) et modifiez son code Python directement ici.

1. L'éditeur — Le code du plugin choisi s'affiche ici, avec coloration syntaxique.
2. Sauvegarder — Enregistre vos modifications directement dans le dossier du plugin.

Paramètres : relier votre serveur Plex

1. Adresse du serveur — Laissez localhost:32400 si Plex tourne sur ce PC, sinon l'adresse IP de la machine qui l'héberge (masquée ici).
2. Jeton Plex — Le X-Plex-Token qui autorise l'application à parler à votre serveur. Il reste sur votre PC.
3. Trouver son jeton — Deux méthodes pas à pas : depuis Plex Web (Voir info XML) ou avec la commande PowerShell fournie, à copier dans un terminal.
4. Tester — Vérifie que l'adresse et le jeton fonctionnent avant d'enregistrer.
5. Chemins personnalisés — Seulement si Plex est installé ailleurs que l'emplacement standard ; laissez vide sinon.
6. Sauvegarder — Enregistre les paramètres sur ce PC.

Prérequis

• Windows 10 ou 11 64‑bits
• Plex Media Server installé localement
• WebView2 Runtime (inclus dans Windows 11 ou installé automatiquement par le setup)

Installation

Windows – installateur recommandé

1. Télécharger le fichier **PlexMetaForge_1.4.1_x64-setup.exe** depuis la release.
2. Double‑cliquer sur le fichier téléchargé pour lancer l’assistant d’installation NSIS.
3. Suivre les instructions à l’écran : accepter le contrat, choisir le dossier d’installation (par défaut %ProgramFiles%\PlexMetaForge) et cliquer sur Installer.
4. Une fois l’installation terminée, cocher « Lancer PlexMetaForge » et cliquer sur Terminer.

Windows – version portable

1. Télécharger le fichier **plexmetaforge-portable.exe** depuis la release.
2. Créer un dossier dédié (par ex. C:\Programmes\PlexMetaForgePortable).
3. Copier le fichier **plexmetaforge-portable.exe** dans ce dossier.
4. Double‑cliquer sur **plexmetaforge-portable.exe** pour lancer l’application sans installation.

Premier lancement

1. Lancer PlexMetaForge depuis le raccourci créé ou le fichier portable.
2. Dans la barre de menus, ouvrir **Paramètres** (icône ⚙).
3. Coller votre **X‑Plex‑Token** dans le champ prévu à cet effet.
4. Cliquer sur **Tester la connexion Plex** pour vérifier que le token est valide.
5. Fermer les paramètres ; l’application est prête à être utilisée.

Gérer les plugins Plex

Liste, activation, désactivation et suppression des bundles .bundle.

1. Ouvrir l’onglet **Gestionnaire de plugins** dans le menu principal.
2. Cliquer sur **Actualiser** pour afficher tous les plugins présents dans le répertoire Plex.
3. Utiliser le bouton **Activer/Désactiver** à côté de chaque plugin selon le besoin.
4. Sélectionner un plugin et cliquer sur **Supprimer** pour le retirer définitivement.
5. Cliquer sur **Sauvegarder** pour créer une copie de sécurité du répertoire plugins.

Installer un plugin depuis le catalogue

Le catalogue propose 60 agents vérifiés installables en un clic.

1. Accéder à l’onglet **Catalogue**.
2. Parcourir la liste ou rechercher le plugin souhaité.
3. Cliquer sur le bouton **Installer** à côté du plugin choisi.
4. Confirmer l’installation dans la boîte de dialogue qui s’affiche.
5. Le plugin apparaît alors dans le Gestionnaire de plugins, prêt à être activé.

Injecter des métadonnées dans Plex

Ajoute automatiquement NFO, affiches, fanart et informations via l’API Plex.

1. Sélectionner un média dans votre bibliothèque Plex via l’interface de PlexMetaForge.
2. Cliquer sur **Injecter métadonnées**.
3. Choisir les sources souhaitées (NFO, poster, fanart, API Plex).
4. Lancer le processus en cliquant sur **Démarrer**.
5. Vérifier le résultat dans Plex : les nouvelles métadonnées doivent être visibles.

Créer un plugin à partir d’un template

Utilisez les cinq modèles fournis pour créer rapidement un nouveau plugin.

1. Ouvrir l’onglet **Créateur de plugins**.
2. Choisir un template parmi Vierge, Films, Séries TV, Musique ou Universel.
3. Saisir le nom du plugin et le répertoire de destination.
4. Cliquer sur **Générer** pour créer la structure de fichiers.
5. Modifier le code Python du plugin directement dans l’éditeur intégré si besoin.

Exporter un plugin en archive ZIP

Permet de partager ou sauvegarder un plugin créé.

1. Dans le Gestionnaire de plugins, sélectionner le plugin à exporter.
2. Cliquer sur le bouton **Export ZIP**.
3. Choisir le dossier de destination pour le fichier .zip.
4. Valider l’exportation ; le fichier ZIP contenant le plugin est créé.

Explorer la base de données SQLite de Plex

Accédez aux tables, repérez les entrées incomplètes et libérez les verrous.

1. Ouvrir l’onglet **Base de données**.
2. Cliquer sur **Ouvrir DB** pour charger le fichier PlexDatabase.db.
3. Utiliser les filtres pour afficher les enregistrements incomplets.
4. Sélectionner les lignes concernées et cliquer sur **Libérer le verrou** si nécessaire.
5. Fermer l’onglet une fois l’inspection terminée.

Astuces

• Sauvegardez régulièrement le répertoire plugins ; PlexMetaForge crée automatiquement une copie avant toute suppression.
• Conservez votre X‑Plex‑Token dans un gestionnaire de mots de passe et ne le partagez pas.
• Si le test de connexion échoue, vérifiez que Plex Media Server est bien démarré et que le token est correct.

Questions fréquentes

Comment récupérer mon X‑Plex‑Token ?

Ouvrez le fichier %LOCALAPPDATA%\Plex Media Server\Preferences.xml et cherchez la valeur de PlexOnlineToken, ou consultez l’URL d’un film dans Plex Web et copiez le paramètre X-Plex-Token.

Puis‑je utiliser PlexMetaForge sur Linux ?

Le README ne mentionne que Windows 10/11 ; aucune version Linux n’est fournie dans la release.

Que faire si l’installation échoue à cause de WebView2 ?

Téléchargez et installez manuellement le runtime WebView2 depuis le site Microsoft, puis relancez l’installateur.

Comment mettre à jour PlexMetaForge ?

Téléchargez la nouvelle version du fichier d’installation ou portable, exécutez‑le et choisissez « Mettre à jour » lorsqu’il le propose.

Liens

• Télécharger v1.4.1
• Code source
• PlexMetaForge sur heiphaistos.org