FAQ - Questions fréquentes
Retrouvez ici les réponses aux questions les plus courantes sur Ygégé.
Général
Qu'est-ce qu'Ygégé exactement ?
Ygégé est un indexeur pour ygg.gratis. Il transforme ygg.gratis en une source compatible avec Prowlarr, Jackett, Sonarr, Radarr et autres applications de gestion de médias. Il expose une API REST qui permet de rechercher des torrents et d'obtenir leurs liens magnets via le protocole Nostr (NIP-35).
Pourquoi utiliser Ygégé plutôt que les définitions Cardigann existantes ?
- Performance : Écrit en Rust, 10-20x plus rapide que les scrapers Python/Node.js
- Nostr natif : Connexion directe au relais
wss://relay.ygg.gratis, sans scraping HTML - TMDB/IMDB : Enrichissement automatique des métadonnées
- Maintenance active : Mises à jour régulières et support de la communauté
- Multi-architecture : Support ARM64/ARMv7 pour NAS et Raspberry Pi
Ygégé est-il légal ?
Ygégé est un logiciel open-source qui fournit une interface technique vers ygg.gratis. L'utilisation de ygg.gratis et le téléchargement de contenus protégés dépendent de la législation de votre pays. Utilisez Ygégé de manière responsable et légale.
Ygégé fonctionne-t-il avec d'autres trackers ?
Non, Ygégé est spécifiquement conçu pour ygg.gratis uniquement. Pour d'autres trackers, utilisez les indexeurs natifs de Prowlarr/Jackett.
Installation et configuration
Dois-je avoir un compte ygg.gratis ?
Non. ygg.gratis est un tracker public — aucun compte ni identifiant n'est requis. Ygégé se connecte directement au relais Nostr public.
Quelle est la différence entre Docker Run et Docker Compose ?
- Docker Run : Commande unique pour démarrer rapidement, mais difficile à maintenir
- Docker Compose : Fichier de configuration réutilisable, facilite les mises à jour et la gestion
Recommandation : Utilisez Docker Compose pour une meilleure gestion à long terme.
Puis-je installer Ygégé sans Docker ?
Oui, vous avez deux options :
- Binaires pré-compilés (Recommandé) : Téléchargez le binaire pour votre plateforme depuis les releases GitHub
- Compilation manuelle : Installez Rust et compilez depuis les sources
Voir le guide de compilation pour plus de détails.
Le port 8715 est-il obligatoire ?
Non, vous pouvez utiliser n'importe quel port libre. Modifiez simplement :
environment:
BIND_PORT: "9090"
ports:
- "9090:9090"
Intégrations
Prowlarr ou Jackett, lequel choisir ?
Prowlarr (recommandé) :
- ✅ Synchronisation automatique avec Sonarr/Radarr/Lidarr
- ✅ Interface moderne
- ✅ Meilleures performances
- ❌ Configuration initiale plus complexe
Jackett :
- ✅ Configuration plus simple
- ✅ Stable et éprouvé
- ❌ Synchronisation manuelle avec les *arr
- ❌ Interface datée
Puis-je utiliser Prowlarr ET Jackett en même temps ?
Techniquement oui, mais ce n'est pas recommandé. Cela créerait des doublons dans vos applications Sonarr/Radarr. Choisissez-en un seul.
Ygégé fonctionne-t-il avec Sonarr/Radarr directement ?
Non. Sonarr et Radarr nécessitent un indexeur intermédiaire (Prowlarr ou Jackett). Ygégé ne supporte pas le protocole Torznab directement.
Workflow recommandé :
Ygégé → Prowlarr → Sonarr/Radarr/Lidarr
Comment mettre à jour le fichier ygege.yml ?
Le fichier ygege.yml définit l'indexeur pour Prowlarr/Jackett. Lorsqu'il est mis à jour sur GitHub :
- Téléchargez la nouvelle version
- Remplacez l'ancien fichier dans
Definitions/Custom/ - Redémarrez Prowlarr/Jackett
Surveillez les releases GitHub pour être notifié des mises à jour.
Performances et limites
Combien de requêtes puis-je faire ?
ygg.gratis étant un tracker public, il n'y a pas de limite liée aux identifiants. Cependant, pour ne pas surcharger le relais Nostr, il est recommandé de ne pas abuser des recherches automatisées.
Espacez vos requêtes (environ 1 par seconde) pour éviter de surcharger le relais Nostr.
Ygégé met en cache les résultats ?
Non, chaque recherche interroge le relais Nostr en temps réel. Cela garantit des résultats toujours à jour.
Le relais Nostr peut-il être inaccessible ?
Oui, dans de rares cas :
- Le relais
wss://relay.ygg.gratisest temporairement indisponible - Problème réseau temporaire
Solution : Vérifiez les logs, attendez quelques minutes, et réessayez.
Quelle est la charge sur le relais ?
Ygégé optimise les requêtes :
- 1 requête = 1 filtre NIP-50 envoyé au relais Nostr
- Pas de spam ou de requêtes abusives
Problèmes courants
"Rate limited" / "Aucun résultat"
Causes possibles :
- Le relais Nostr est temporairement surchargé
- Trop de requêtes envoyées en peu de temps
Solutions :
- Vérifiez les logs :
docker logs ygege - Attendez quelques minutes avant de réessayer
- Réduisez la fréquence des recherches automatisées
- Redémarrez Ygégé
"Connection refused" sur localhost:8715
Causes possibles :
- Ygégé n'est pas démarré
- Le port est différent
- Problème de firewall
Diagnostic :
docker ps | grep ygege # Vérifier que le conteneur tourne
docker logs ygege # Voir les erreurs
curl http://localhost:8715/health # Tester l'API
Aucun résultat dans Prowlarr/Jackett
Checklist :
- Ygégé est démarré :
curl http://localhost:8715/health - URL correcte dans Prowlarr/Jackett (
http://localhost:8715/ouhttp://ygege:8715/) - Fichier
ygege.ymlà jour - Prowlarr/Jackett redémarré après ajout du fichier
- Relais Nostr accessible :
curl http://localhost:8715/status
Erreur 503 "Service Unavailable"
Le relais Nostr est temporairement indisponible. Attendez et réessayez.
Les téléchargements ne démarrent pas
Ygégé fournit des liens magnet (pas de fichiers .torrent). Le téléchargement effectif est géré par :
- Votre client BitTorrent (qBittorrent, Transmission, etc.)
- Sonarr/Radarr (si configuré avec un client torrent)
Vérifiez la configuration de votre client BitTorrent et assurez-vous que Prowlarr/Jackett est configuré pour utiliser les magnets.
Docker et déploiement
Puis-je utiliser Ygégé sur des architectures anciennes (NAS, systèmes embarqués) ?
Oui ! Si vous rencontrez des erreurs de segmentation (segfault) sur des architectures anciennes ou certains NAS (comme Synology), utilisez l'image uwucode/ygege:noupx compilée sans compression UPX :
image: uwucode/ygege:noupx
Cette version est compatible avec les systèmes qui ne supportent pas les binaires compressés avec UPX.
Ygégé fonctionne-t-il sur Raspberry Pi ?
Oui ! Les images Docker supportent ARMv7 et ARM64 :
- Raspberry Pi 3/4/5 : ✅ Support complet
- Architecture : ARM64 ou ARMv7
Comment mettre à jour Ygégé ?
Avec Docker Compose :
docker compose pull
docker compose up -d
docker image prune -f
Avec Docker Run :
docker stop ygege
docker rm ygege
docker pull uwucode/ygege:latest
# Relancer la commande docker run
Puis-je exécuter plusieurs instances d'Ygégé ?
Oui, mais ce n'est généralement pas nécessaire. Si vous le faites :
- Utilisez des ports différents
- Utilisez des noms de conteneurs différents
Comment sauvegarder ma configuration ?
Sauvegardez simplement le dossier ./config :
# Sauvegarder
tar -czf ygege-backup.tar.gz ./config
# Restaurer
tar -xzf ygege-backup.tar.gz
TMDB et IMDB
Comment activer TMDB/IMDB ?
- Créez un compte sur TMDB
- Générez un token API dans les paramètres de votre compte
- Configurez Ygégé :
environment:
TMDB_TOKEN: "votre_token_tmdb"
Lorsque TMDB_TOKEN est configuré, les résolveurs TMDB et IMDB sont automatiquement activés ensemble.
À quoi servent les métadonnées TMDB/IMDB ?
Elles enrichissent automatiquement les résultats avec :
- Titres officiels
- Affiches et images
- Notes et popularité
- Correspondances exactes pour Sonarr/Radarr
TMDB/IMDB est-il obligatoire ?
Non, c'est optionnel. Ygégé fonctionne parfaitement sans. Les métadonnées améliorent simplement la précision des recherches.
Sécurité
Ygégé expose-t-il mes données personnelles ?
Non. Ygégé ne collecte, ne stocke ni ne transmet aucune donnée personnelle. Il communique uniquement avec :
- Les relais Nostr de ygg.gratis (pour les recherches)
- TMDB (si configuré, pour les métadonnées)
Dois-je exposer Ygégé sur Internet ?
Non, ce n'est pas recommandé. Ygégé est conçu pour être utilisé en réseau local (LAN). Si vous devez l'exposer :
- Utilisez un reverse proxy (Nginx, Traefik)
- Ajoutez une authentification (Basic Auth, OAuth)
- Utilisez HTTPS
Ygégé peut-il être piraté ?
Comme tout logiciel, des vulnérabilités peuvent exister. Pour minimiser les risques :
- Mettez à jour régulièrement
- N'exposez pas sur Internet sans protection
- Utilisez un réseau isolé si possible
Support et contribution
Où signaler un bug ?
Ouvrez une issue sur GitHub : github.com/UwUDev/ygege/issues
Incluez :
- Version d'Ygégé
- Logs pertinents
- Configuration
- Étapes pour reproduire
Comment contribuer au projet ?
- 🐛 Signaler des bugs
- 📖 Améliorer la documentation
- 💻 Proposer des pull requests
- ⭐ Mettre une étoile sur GitHub
Voir le guide de contribution.
Ygégé est-il maintenu activement ?
Oui ! Consultez l'historique des commits et les releases pour voir l'activité récente.
Autres questions
Quelle est la différence entre les tags Docker ?
| Tag | Description | Usage |
|---|---|---|
latest | Dernière version stable | Production (recommandé) |
stable | Alias de latest | Production |
noupx | Sans compression UPX | Synology NAS |
0.6.2 | Version spécifique | Blocage de version |
develop | Version de développement | Tests uniquement |
Puis-je utiliser Ygégé commercialement ?
Ygégé est sous licence open-source. Vérifiez la LICENSE pour les détails. L'utilisation commerciale dépend également des CGU de ygg.gratis.
Ygégé collecte-t-il des statistiques ?
Non. Aucune télémétrie, aucun tracking. Ygégé est 100% privé et fonctionne entièrement en local.
Votre question n'est pas listée ? Consultez la documentation complète ou ouvrez une issue sur GitHub.