Gameyfin : Votre Bibliothécaire de Jeux Vidéo Ultime, Simplifié avec Docker

Gameyfin : Votre Bibliothécaire de Jeux Vidéo Ultime, Simplifié avec Docker

Dans l’univers foisonnant du jeu vidéo, il est facile de se perdre. Entre les plateformes (Steam, Epic Games Store, GOG, Humble Bundle…), les émulateurs et les jeux indépendants, notre collection digitale peut rapidement devenir un véritable labyrinthe. C’est là qu’intervient Gameyfin, un outil open-source et auto-hébergé conçu pour centraliser et organiser toute votre bibliothèque de jeux vidéo, quel que soit leur provenance.

Imaginez une interface élégante qui regroupe tous vos jeux, avec leurs jaquettes, descriptions, informations sur les plates-formes, et même l’accès direct au lancement. Gameyfin, c’est un peu le « Plex » ou le « Kodi » pour vos jeux vidéo. Et le meilleur dans tout ça ? Il est incroyablement simple à installer grâce à Docker !

Qu’est-ce que Gameyfin et pourquoi en avez-vous besoin ?

Gameyfin est une application web qui vous permet de :

• Centraliser votre collection : Scannez vos dossiers de jeux pour que Gameyfin détecte automatiquement vos titres, qu’ils soient installés via Steam, des jeux GOG sans DRM, des jeux indépendants, ou même des ROMs d’émulateurs.
• Embellir votre bibliothèque : Il télécharge automatiquement les métadonnées (jaquettes, descriptions, dates de sortie, genres, etc.) pour chaque jeu, transformant une simple liste de fichiers en une collection visuellement riche.
• Découverte et organisation : Explorez votre collection par genre, plateforme, ou utilisez la fonction de recherche pour retrouver ce vieux classique que vous aviez oublié.
• Auto-hébergé : Vous gardez le contrôle total de vos données, sans dépendre de services tiers.

Pour tout gamer qui se respecte, Gameyfin est un must-have pour mettre de l’ordre dans le chaos numérique de sa ludothèque.

Installation Facile avec Docker Compose : Le Guide Complet

L’un des grands avantages de Gameyfin est sa facilité d’installation grâce à Docker et Docker Compose. Cela vous permet de le déployer rapidement sur n’importe quel serveur ou Raspberry Pi, sans vous soucier des dépendances logicielles.

Voici comment procéder, étape par étape, en utilisant le fichier docker-compose.yml que vous avez fourni.

Prérequis

Avant de commencer, assurez-vous d’avoir les éléments suivants :

1. Docker et Docker Compose installés : Si ce n’est pas le cas, suivez les guides officiels pour votre système d’exploitation (Linux, macOS, Windows WSL2).
2. Un répertoire pour Gameyfin : Créez un dossier où vous stockerez votre configuration Docker. Par exemple : /opt/docker/gameyfin.
3. Un répertoire pour vos jeux : C’est le dossier où tous vos jeux sont stockés. Par exemple : /chemin/vers/mes_jeux.

Étape 1 : Créer le fichier docker-compose.yml

Dans votre répertoire Gameyfin (ex: /opt/docker/gameyfin), créez un fichier nommé docker-compose.yml et collez-y le contenu suivant :

services:
  gameyfin:
    image: ghcr.io/gameyfin/gameyfin:2
    container_name: gameyfin
    restart: unless-stopped
    environment:
      # Generate a new APP_KEY using the command `openssl rand -base64 32` or similar.
      APP_KEY: yourappkey_a_generer # <-- Important : Générez cette clé !

      # (optional) Set the URL of your Gameyfin instance if you are using a reverse proxy.
      #  APP_URL: https://gameyfin.example.com # Change this to your actual URL if needed

      # (optional) Set the user and group ID to run Gameyfin with a specific user.
      PUID: 1000 # Change this to your user ID if needed
      PGID: 1000 # Change this to your group ID if needed
    volumes:
      - "/opt/docker/gameyfin/db:/opt/gameyfin/db" # Base de données de Gameyfin
      - "/opt/docker/gameyfin/data:/opt/gameyfin/data" # Données additionnelles (jaquettes, etc.)
      - "/opt/docker/gameyfin/logs:/opt/gameyfin/logs" # Journaux de l'application
      - "/chemin/vers/mes_jeux:/opt/gameyfin/games:ro" # <-- **TRÈS IMPORTANT : Modifiez ce chemin !**
    ports:
      - "8080:8080"
      # If you plan to use the included torrent plugin, uncomment the following lines (optional):
      # - "6969:6969"
      # - "6881:6881"

Étape 2 : Personnalisation du fichier docker-compose.yml

Avant de lancer le conteneur, vous devez absolument modifier certaines lignes :

1. APP_KEY: yourappkey_a_generer
   • C’est une clé de sécurité essentielle pour votre application. Ne laissez pas la valeur par défaut !
   • Pour générer une clé sécurisée, ouvrez un terminal et exécutez la commande suivante : openssl rand -base64 32
   • Copiez le résultat (une longue chaîne de caractères) et collez-le à la place de yourappkey_a_generer.
2. PUID: 1000 et PGID: 1000
   • Ces valeurs définissent l’ID de l’utilisateur et du groupe sous lesquels le processus Gameyfin s’exécutera à l’intérieur du conteneur.
   • Pour des raisons de permissions (notamment pour accéder à vos fichiers de jeux), il est souvent recommandé de faire correspondre ces IDs à ceux de l’utilisateur de votre système qui possède les fichiers de jeux.
   • Vous pouvez trouver vos PUID et PGID en exécutant la commande id $USER dans votre terminal. Par exemple, si votre utilisateur principal est johndoe, faites id johndoe. La plupart du temps, 1000 est correct pour les premiers utilisateurs sur les systèmes Linux.
3. volumes : Le chemin vers vos jeux !
   • La ligne la plus cruciale pour que Gameyfin puisse voir vos jeux "/chemin/vers/mes_jeux:/opt/gameyfin/games:ro"
   • Remplacez /chemin/vers/mes_jeux par le chemin absolu de votre dossier contenant tous vos jeux. Par exemple : /mnt/stockage/jeux ou C:\Users\VotreNom\MesJeux (attention à la syntaxe sous Windows avec Docker Desktop).
   • Le :ro signifie « read-only » (lecture seule), ce qui est une bonne pratique pour éviter que Gameyfin ne modifie accidentellement vos fichiers de jeux.
4. APP_URL (optionnel)
   • Si vous prévoyez d’accéder à Gameyfin via un proxy inverse (comme Nginx ou Traefik) avec un nom de domaine (ex: https://gameyfin.mondomaine.com), décommentez cette ligne et mettez votre URL.
5. Ports Torrent (optionnel)
   • Si vous avez l’intention d’utiliser le plugin de torrent inclus dans Gameyfin (pour télécharger des ROMs, par exemple), décommentez les lignes des ports 6969 et 6881.

Étape 3 : Lancer Gameyfin avec Docker Compose

Une fois que vous avez personnalisé votre fichier docker-compose.yml, ouvrez un terminal, naviguez jusqu’au répertoire où vous avez créé le fichier (ex: cd /opt/docker/gameyfin) et exécutez la commande suivante :

docker compose up -d

• docker compose up : Lance les services définis dans le fichier docker-compose.yml.
• -d : Détache le processus du terminal, faisant tourner Gameyfin en arrière-plan.

Le téléchargement de l’image Docker de Gameyfin va commencer (cela peut prendre quelques minutes la première fois), puis le conteneur sera démarré.

Étape 4 : Accéder à Gameyfin

Ouvrez votre navigateur web et accédez à l’adresse suivante :

http://localhost:8080

Si vous avez installé Gameyfin sur un serveur distant, remplacez localhost par l’adresse IP de votre serveur (ex: http://192.168.1.100:8080).

Vous devriez voir l’interface de Gameyfin ! Lors de la première connexion, vous serez invité à créer un compte administrateur.

Étape 5 : Ajouter vos jeux

Une fois connecté à l’interface de Gameyfin :

1. Allez dans les paramètres (souvent une icône de roue dentée).
2. Cherchez l’option pour « scanner » ou « ajouter des répertoires de jeux ».
3. Ajoutez le chemin /opt/gameyfin/games. C’est le chemin à l’intérieur du conteneur Docker qui pointe vers votre dossier de jeux (le volume que vous avez monté précédemment).
4. Lancez le scan, et Gameyfin commencera à peupler votre bibliothèque avec toutes les informations.

Conclusion

Voilà ! Vous avez maintenant votre propre instance Gameyfin opérationnelle, prête à organiser et embellir toute votre collection de jeux vidéo. Grâce à Docker Compose, l’installation est propre, isolée et facilement reproductible. Profitez de votre nouvelle bibliothèque de jeux centralisée et dites adieu au désordre !