ntrehel 405514736e
Image Docker / build (push) Successful in 6m33s
chore(release): 2.1.0
2026-11-04 22:30:04 +01:00
2026-11-04 22:30:04 +01:00
2026-11-04 22:30:04 +01:00
2026-11-04 22:30:04 +01:00
2026-11-04 22:30:04 +01:00

🐍 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

Agora Logo

"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

Screenshot

Qualités

Screenshot


🛠️ 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 ~/.agora sur votre machine (modifiable avec AGORA_HOME dans le .env), monté sur /data dans 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 ./downloads est monté sur /downloads, pour les fichiers déposés à l'attention de JDownloader.
  • pyLoad-ng (au lieu de JDownloader) : décommentez le service pyload et les volumes films / series du docker-compose.yml. Les deux conteneurs partagent ./downloads. Dans Paramètres → Téléchargements, renseignez l'adresse http://pyload:8000, la clé d'API de pyLoad (Settings → Users → API keys), puis les dossiers /downloads, /media/films et /media/series, et cliquez sur Tester. Chaque téléchargement terminé est rangé dans Films/<Titre>/ ou Séries/<Titre>/.
  • Mise à jour : docker compose pull && docker compose up -d, ou en un clic depuis Paramètres → Système avec le service facultatif agora-updater : décommentez-le dans le docker-compose.yml et ajoutez au .env une ligne AGORA_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 passer agora_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.

  1. Téléchargez l'archive sur la page Télécharger (ou l'asset Agora-install-<version>.zip de la release Gitea) et extrayez-la : elle contient un dossier Agora.
  2. Lancez Agora.cmd (Windows, double-clic) ou sh 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 make installé, vous pouvez simplifier les commandes :

  • make start : Installe, compile et lance l'application.
  • make dev : Développement avec rechargement automatique (ou npm 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

  1. Ouvrez http://localhost:3067 : Agora vous envoie sur la page de création du premier compte admin. Vous pouvez aussi le créer automatiquement avec ADMIN_USERNAME et ADMIN_PASSWORD dans le .env.
  2. Un assistant vous fait choisir et installer vos sources, les configurer (adresses, identifiants), puis vérifie qu'elles répondent.
  3. 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 .env continue 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 :

  1. Dans Paramètres → Système, renseignez l'URL publique (ex : https://agora.mondomaine.fr).
  2. 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.
  3. Le cookie de session devient automatiquement « Secure » dès que la connexion est en HTTPS.
  4. 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 de SECRET), 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).

S
Description
Agora - API Proxy and Frontend
Readme
28 MiB
1 Stars 1 Watchers 0 Forks
Agora 2.1.0
Latest
2026-11-04 21:30:04 +00:00
Languages
TypeScript 49.5%
JavaScript 32.3%
CSS 8.7%
EJS 8.2%
HTML 0.8%
Other 0.5%