🐍 Agora
Important
Merci de bien lire tout ça avant de déployer le server
Si vous êtes débutant(e), le tutoriel pas à pas et la vidéo de présentation de la 2.1 répondront à vos questions :
Tutoriel et vidéo · Télécharger Agora et la base locale
"Un immense merci à l'équipe technique d'Hydracker pour sa générosité. On a trouvé votre API tellement 'ouverte d'esprit' qu'on s'est permis de l'aider à partager ses liens sans les contraintes futiles d'un navigateur ou d'un abonnement. C'est presque trop facile, mais comme on dit : c'est l'intention qui compte." 💅
🚀 Présentation
Agora est une solution complète (serveur + interface web) pour rechercher, suivre les tendances et récupérer les liens de téléchargement de vos films et séries depuis plusieurs sources, avec envoi direct vers JDownloader.
Depuis la v2, Agora est livré sans source : chaque source est un plugin que vous choisissez et installez depuis la marketplace, dans Paramètres → Sources. Les sources officielles sont développées dans le dépôt Agora_plugins :
| Source | Compte requis |
|---|---|
| Zone-Téléchargement | oui (compte membre du site) |
| Zone-Téléchargement (Team) | non |
| Free-Télécharger | non |
| Movix, Loadix | non |
| FS24, FlixArt | oui |
| Base locale (LocalDB, recherche hors-ligne) | non |
La communauté peut aussi proposer ses propres plugins sur la marketplace (voir Plugins).
L'historique des versions est dans CHANGELOG.md.
✨ Fonctionnalités
- 🔍 Recherche, tendances et ajouts récents sur toutes vos sources actives, avec les liens triés selon vos hébergeurs préférés.
- 🧩 Sources à la carte : installation, mise à jour et configuration depuis l'interface, sans redémarrer.
- 🗄️ Base locale : recherche instantanée et hors-ligne (films, séries, jeux, logiciels…) avec le plugin LocalDB.
- 🔗 Liens en un clic, ou envoi automatique vers JDownloader ou pyLoad-ng (avec pyLoad, Agora range les téléchargements terminés dans vos dossiers Films et Séries).
- Débrideurs AllDebrid et Real-Debrid (2.1) : les liens des hébergeurs pris en charge passent par votre compte avant l'envoi ; une pastille les signale dans la liste.
- Mise à jour en un clic (2.1) : version signée vérifiée, réglages sauvegardés, retour automatique à la version précédente si la nouvelle ne démarre pas. Sans Docker, ou sous Docker avec le service facultatif
agora-updater. - 👥 Plusieurs utilisateurs : les admins gèrent les réglages, les autres comptes n'ont accès qu'à l'application.
- 🎬 Affiches et titres enrichis par TMDB (facultatif, clé gratuite).
- 💻 Interface moderne et responsive, installable comme une application (PWA).
- 🏠 Pensé pour la maison : fonctionne en HTTP sur votre réseau local, HTTPS seulement si vous l'exposez sur Internet.
📸 Screenshots
Interface Web
Qualités
🛠️ Installation
🐳 Via Docker (Recommandé)
L'image nonobzh22/agora (Docker Hub, amd64 et arm64) est construite à chaque version : rien à compiler.
# 1. Récupérer le docker-compose.yml et la configuration
mkdir agora && cd agora
curl -O https://git.nolhantirer.space/ntrehel/Agora/raw/branch/main/docker-compose.yml
[ -f .env ] || curl -o .env https://git.nolhantirer.space/ntrehel/Agora/raw/branch/main/.env.exemple
# 2. Lancer Agora
docker compose up -d
📍 Accès : http://localhost:3067
- Les données sont gardées dans
~/.agorasur votre machine (modifiable avecAGORA_HOMEdans le.env), monté sur/datadans le conteneur. - Agora tourne sans les droits root dans le conteneur : au démarrage, il rend lui-même son dossier de données à son utilisateur (uid 1000).
- Le dossier
./downloadsest monté sur/downloads, pour les fichiers déposés à l'attention de JDownloader. - pyLoad-ng (au lieu de JDownloader) : décommentez le service
pyloadet les volumesfilms/seriesdudocker-compose.yml. Les deux conteneurs partagent./downloads. Dans Paramètres → Téléchargements, renseignez l'adressehttp://pyload:8000, la clé d'API de pyLoad (Settings → Users → API keys), puis les dossiers/downloads,/media/filmset/media/series, et cliquez sur Tester. Chaque téléchargement terminé est rangé dansFilms/<Titre>/ouSéries/<Titre>/. - Mise à jour :
docker compose pull && docker compose up -d, ou en un clic depuis Paramètres → Système avec le service facultatifagora-updater: décommentez-le dans ledocker-compose.ymlet ajoutez au.envune ligneAGORA_UPDATER_TOKEN=suivie de 64 caractères (openssl rand -hex 32). L'updater a accès au socket Docker : il n'ouvre aucun port, exige ce jeton, et ne sait que passeragora_appà une version officielle dont il vérifie la signature et l'empreinte, avec retour arrière si elle ne démarre pas.
💻 Installation sans Docker (archive prête à lancer)
Prérequis : Node.js v22+ (Agora utilise le module SQLite intégré de Node). Rien d'autre : pas de compilation ni de npm install.
- Téléchargez l'archive sur la page Télécharger (ou l'asset
Agora-install-<version>.zipde la release Gitea) et extrayez-la : elle contient un dossierAgora. - Lancez
Agora.cmd(Windows, double-clic) oush agora.sh(Linux, macOS).
📍 Accès : http://localhost:3067
Le dossier contient un petit lanceur (launcher.mjs) et la version d'Agora dans versions/<version>/. Les réglages de démarrage (port…) vont dans un .env à la racine du dossier (copie de .env.exemple) ; les données restent dans ~/.agora. Les mises à jour se font ensuite en un clic depuis Paramètres → Système : Agora vérifie la version signée, la télécharge, sauvegarde ses réglages et passe la main au lanceur, qui revient à la version précédente si la nouvelle ne démarre pas (journal : update.log).
Depuis les sources (développement)
git clone https://git.nolhantirer.space/ntrehel/Agora.git
cd Agora
cp .env.exemple .env
npm install
npm run build && npm start
Tip
Si vous avez
makeinstallé, vous pouvez simplifier les commandes :
make start: Installe, compile et lance l'application.make dev: Développement avec rechargement automatique (ounpm run dev).
Une installation par Git se met à jour par git pull && npm ci && npm run build : la mise à jour en un clic est réservée à l'archive prête à lancer.
Mise à jour depuis la 2.0.x
Docker : rien ne change (docker compose pull && docker compose up -d) ; ajoutez agora-updater si vous voulez la mise à jour en un clic pour les suivantes.
Sans Docker : la 2.1 introduit l'archive prête à lancer, qu'il faut installer à la main une dernière fois. Arrêtez l'ancienne version, extrayez la nouvelle archive dans un nouveau dossier, copiez-y votre ancien .env s'il en existait un, et lancez Agora.cmd / sh agora.sh. Comptes, sources et réglages sont repris depuis ~/.agora.
⬆️ Mise à jour depuis la 1.5.x
Au premier démarrage, Agora 2 reprend l'ancienne installation : comptes, sessions, réglages et bases sont copiés dans son dossier de données, les mots de passe et clés y sont chiffrés, puis retirés de l'ancien database/config.json. Vos sources sont réinstallées dans leur version 2.
Docker : ajoutez le volume des données à votre docker-compose.yml, en gardant ./database et ./sessions pour ce premier démarrage (ou reprenez le docker-compose.yml de la v2, qui contient déjà ces lignes) :
volumes:
- ./data:/data # à ajouter : données d'Agora 2 (dossier data à côté du docker-compose.yml)
- ./database:/app/database # à garder pour la reprise
- ./sessions:/app/sessions
Puis docker compose pull && docker compose up -d. Sans ce volume, Agora fonctionne quand même : il garde ses données dans ./database/agora-data et vous le signale dans Paramètres ; ajoutez le volume quand vous voulez, elles y seront recopiées au redémarrage.
Installation manuelle : décompressez la nouvelle version dans le dossier de la 1.5.x (ses dossiers database/ et sessions/ restent en place), puis npm install, npm run build et npm start. Les données sont reprises dans ~/.agora.
🚪 Premier démarrage
- Ouvrez
http://localhost:3067: Agora vous envoie sur la page de création du premier compte admin. Vous pouvez aussi le créer automatiquement avecADMIN_USERNAMEetADMIN_PASSWORDdans le.env. - Un assistant vous fait choisir et installer vos sources, les configurer (adresses, identifiants), puis vérifie qu'elles répondent.
- Ensuite, tout se règle dans Paramètres (réservé aux admins) : Général, Sources, Téléchargements (JDownloader, pyLoad, débrideur), Système (dont les mises à jour), Utilisateurs.
Note
Sur une installation neuve ouverte depuis Internet, la page de création du premier compte admin demande un code de création, affiché dans les journaux d'Agora au démarrage (
docker logs agora_app). Depuis le réseau local, ce code n'est pas demandé.
⚙️ Configuration (.env)
Le .env ne contient que ce qui sert au démarrage du serveur (voir .env.exemple) :
| Variable | Type | Description |
|---|---|---|
PORT |
Optionnel | Port de l'application (Défaut : 3067). |
SECRET |
Optionnel | Clé des sessions et du chiffrement des secrets. Vide : générée au premier démarrage dans le dossier des données (fichier secret). |
TRUST_PROXY |
Optionnel | Proxys dont les en-têtes X-Forwarded-* sont crus. Défaut : proxy local uniquement (même machine, Docker, réseau local). false, true, un nombre ou une liste d'adresses. |
AGORA_HOME |
Optionnel (Docker) | Dossier de la machine où sont gardées les données (Défaut : ~/.agora). |
AGORA_DATA_DIR |
Optionnel (manuel) | Dossier des données d'Agora (Défaut : ~/.agora). |
ADMIN_USERNAME / ADMIN_PASSWORD |
Optionnel | Création automatique du premier admin. Retirez le mot de passe du fichier une fois le compte créé. |
AGORA_UPDATER_TOKEN |
Optionnel (Docker) | Jeton partagé avec le service agora-updater (64 caractères, openssl rand -hex 32) : active la mise à jour en un clic sous Docker. |
AGORA_PLUGINS_DIR |
Développement | Charge des plugins compilés sans les installer (voir Plugins). |
Important
Les sources ne se configurent plus dans le
.env. Leurs adresses et identifiants se règlent dans Paramètres → Sources, où les mots de passe sont chiffrés. TMDB, JDownloader, le rafraîchissement, l'URL publique et le HTTPS se règlent dans Paramètres → Système. Une ancienne installation qui garde ces variables dans son.envcontinue de fonctionner : elles servent de valeurs par défaut.
Où est passé le .env ?
Le .env ne sert plus qu'au démarrage du serveur : le port, la clé SECRET et le dossier de données (voir section précédente). Les adresses et identifiants de vos sources se règlent maintenant dans Paramètres → Sources → Configurer, où les secrets sont chiffrés sur le disque. Si vous migrez une ancienne installation qui contient ces variables dans le .env, elles restent lues comme valeurs par défaut tant que vous n'avez rien saisi dans les Paramètres.
Sous Docker, le .env n'est lu que si votre docker-compose.yml contient une ligne env_file: .env (vérifiez dans le fichier fourni).
La base locale (darkiworld.db) se place dans <dossier de données>/database/ — par défaut ~/.agora/database/ sur votre machine, ou /data/database/ dans le conteneur Docker. Son chemin peut aussi être indiqué dans Paramètres → Sources → Base de données locale → Configurer.
🔒 Accès en local ou depuis Internet
En local (http://localhost:3067, ou http://192.168.x.x:3067 depuis une tablette ou un autre PC de la maison) : le HTTP suffit, il n'y a rien à régler. Le cookie de session n'y est pas marqué « Secure », c'est voulu : un réseau local n'a pas de HTTPS.
Exposé sur Internet : passez obligatoirement par un reverse proxy HTTPS (Caddy, Nginx Proxy Manager, Traefik…). En HTTP sur Internet, votre mot de passe et votre session circuleraient en clair. Ensuite :
- Dans Paramètres → Système, renseignez l'URL publique (ex :
https://agora.mondomaine.fr). - Depuis cette adresse HTTPS, activez Forcer le HTTPS : les accès HTTP venant d'Internet sont redirigés, l'accès local en HTTP reste possible.
- Le cookie de session devient automatiquement « Secure » dès que la connexion est en HTTPS.
- Si le reverse proxy n'est ni sur la même machine, ni dans Docker, ni sur le réseau local, indiquez son adresse dans
TRUST_PROXY.
Plus de détails sur la sécurité d'Agora : SECURITY.md.
📁 Données (~/.agora)
Toutes les données persistantes vivent dans un seul dossier (~/.agora par défaut, /data dans le conteneur Docker) :
~/.agora/
├── config.json # Réglages ; mots de passe et clés y sont chiffrés
├── secret # Clé générée au premier démarrage si SECRET est vide
├── users.json # Comptes utilisateurs
├── settings.json # Sources actives et leur ordre
├── sessions/ # Sessions de connexion
├── plugins/ # Plugins installés
├── vault/ # Coffre chiffré des plugins (sessions de connexion aux sites, jetons)
└── database/ # Bases SQLite (LocalDB)
Base locale (LocalDB) : placez darkiworld.db dans database/ (~/.agora/database/darkiworld.db, ou /data/database/darkiworld.db dans le conteneur), ou indiquez son chemin dans la configuration du plugin. Elle est prise en compte sans redémarrage ; si elle n'est pas reconnue, le journal d'Agora indique le chemin attendu. Cette base est ancienne : une grande partie de ses liens ne fonctionnent plus.
Warning
Sauvegardez le dossier en entier. Sans le fichier
secret(ou la même valeur deSECRET), les mots de passe enregistrés sont illisibles et doivent être ressaisis.
Venant d'une v1 : au premier démarrage, l'ancienne installation (database/, sessions/, plugins/) est migrée automatiquement. Les données sont copiées, les plugins réinstallés dans leur version v2, puis les mots de passe et cookies restés en clair dans l'ancien dossier en sont retirés. Une fois la migration vérifiée, les anciens dossiers peuvent être supprimés.
🧩 Plugins
Les sources sont développées dans le dépôt Agora_plugins et publiées une par une (un ZIP par plugin).
- Plugins officiels : signés. Agora vérifie leur signature avant de les installer ou de les mettre à jour.
- Plugins communautaires : proposés par la communauté et validés sur la marketplace avant publication. Agora vérifie que le fichier installé est exactement celui qui a été validé. Leurs réglages sont cloisonnés : un plugin communautaire ne voit que les siens, jamais ceux d'Agora ni des autres plugins. Leur code s'exécute tout de même sur votre serveur : n'installez que ceux en qui vous avez confiance.
Pour installer un plugin à la main, décompressez son ZIP dans ~/.agora/plugins/<id>/. Pour créer un plugin, suivez le README du dépôt Agora_plugins ; pour le tester sans l'installer :
AGORA_PLUGINS_DIR=../Agora_plugins/build npm run dev
Le dossier ./plugins/ de ce dépôt est ignoré par Git : il reste scanné en fallback pour le développement.
🤝 Un Projet Communautaire
Agora est un projet fait par la communauté, pour la communauté. Parce que le savoir (et les liens de téléchargement) ne devrait jamais être prisonnier derrière des murs de paye ou des scripts de sécurité mal conçus. Chaque Pull Request est la bienvenue, tant qu'elle contribue à rendre l'accès encore plus fluide et... disons, "généreux".
Note Liminaire
Cet outil est une preuve de concept destinée à la recherche et à l'apprentissage. Son auteur ne cautionne aucun usage abusif ni aucune violation de droits tiers. Il appartient à chaque utilisateur de s'assurer que ses activités restent conformes à la législation ; la responsabilité de l'usage incombe exclusivement à l'utilisateur final.
📜 Licence
Projet sous licence MIT. Faites-en bon usage (ou pas, on ne juge pas).

