Ecosyste.ms: Awesome
An open API service indexing awesome lists of open source software.
https://github.com/johan-perso/yggdownloaderbot
Un bot Telegram pour rechercher et télécharger des torrents
https://github.com/johan-perso/yggdownloaderbot
deezer-api deezer-downloader telegram telegram-bot torrent torrent-downloader yggtorrent youtube-downloader
Last synced: 2 months ago
JSON representation
Un bot Telegram pour rechercher et télécharger des torrents
- Host: GitHub
- URL: https://github.com/johan-perso/yggdownloaderbot
- Owner: johan-perso
- License: mit
- Created: 2023-06-13T12:00:48.000Z (over 1 year ago)
- Default Branch: main
- Last Pushed: 2023-11-01T21:53:28.000Z (about 1 year ago)
- Last Synced: 2024-05-06T12:26:28.524Z (9 months ago)
- Topics: deezer-api, deezer-downloader, telegram, telegram-bot, torrent, torrent-downloader, yggtorrent, youtube-downloader
- Language: JavaScript
- Homepage:
- Size: 45.9 KB
- Stars: 15
- Watchers: 1
- Forks: 1
- Open Issues: 0
-
Metadata Files:
- Readme: README.md
- License: LICENSE
Awesome Lists containing this project
README
> [!WARNING]
> Ce projet n'est plus maintenu, vous pouvez continuer de signaler des problèmes et j'essayerai de les régler, mais aucune fonctionnalité ne sera rajouté dans ce bot.
# yggDownloaderBot
Ce bot Telegram vous permet de rechercher et télécharger des torrents depuis les plateformes d'YggTorrent et de "Cpasbien". Cela peut être utilisé pour faciliter le téléchargement de fichiers sur un serveur de médias comme Plex ou un NAS, mais aussi pour faire des recherches depuis votre téléphone puisqu'il est possible de désactiver le téléchargement des fichiers depuis le bot. Il est également possible de télécharger directement en envoyant l'URL d'un fichier torrent, d'une vidéo ou d'une playlist YouTube.
https://github.com/johan-perso/yggdownloaderbot/assets/41506568/ffb03795-4f52-44eb-a9db-97232aec8784
## Fonctionnalités
- Recherche de torrents sur plusieurs plateformes
- Affichage de la taille des fichiers, et du nombre de seeders
- Possibilité de télécharger les torrents sur le serveur
- Supporte les recherches à partir de liens Plex (ex: https://watch.plex.tv/movie/avatar-2)
- Filtre les torrents en fonction du nombre de seeders
- Télécharge des torrents en envoyant l'URL du fichier
- Télécharge des vidéos et playlist depuis YouTube (en .mp4) et YouTube Music (en .mp3)
## Installation
> **___⚠️ Disclaimer :___ Ce bot vous est proposé à but éducatif, je ne suis responsable de l'utilisation que vous en faites. Veillez à respecter les lois en vigueur dans votre pays. Un VPN peut être utilisé pour plus de sécurité.**
> Les sites de torrents sont souvent bloqués par les FAI français. Il est possible de contourner ce blocage en modifiant vos DNS.
### Prérequis
- [Node.js](https://nodejs.org/en/) (version 14 ou supérieure)
- Un compte [Telegram](https://telegram.org/)
- Le token d'un bot Telegram (utiliser [BotFather](https://t.me/botfather))
### Installation
1. Cloner le repository
```sh
git clone https://github.com/johan-perso/yggdownloaderbot.git
```
2. Installer les dépendances
```sh
cd yggdownloaderbot
npm install
# ou "pnpm install" si vous utilisez pnpm
```
3. Créer un fichier `.env` à la racine du projet, et y ajouter les variables suivantes :
```sh
BOT_TOKEN=token_du_bot_telegram # Token du bot Telegram, obtenu avec BotFather
AUTHORIZED_USERS=123456789,987654321 # Liste des IDs des utilisateurs autorisés, séparés par des virgules. Obtenir son ID : https://www.youtube.com/watch?v=e_d3KqI6zkI
DOWNLOAD_PATH= # Chemin vers le dossier où seront téléchargés les fichiers. Exemple : /home/user/Downloads. Si non renseigné, les torrents ne seront pas téléchargés. Le dossier doit déjà exister.
```
4. Lancer le bot
```sh
npm start
# ou vous pouvez utiliser pm2 pour le lancer en arrière plan
pm2 start index.js --name "yggdownloaderbot"
```
## Utilisation
Pour effectuer une recherche, vous n'avez qu'à envoyer le terme que vous souhaitez chercher par message au bot (par exemple : `avatar 2`).
> Vous pouvez également rechercher un film ou une série sur Plex, et copier le lien de la page (qui commence par `https://watch.plex.tv/movie/` ou `https://watch.plex.tv/show/`).
Le bot vous répondra avec une liste de résultats, vous pourrez choisir lequel télécharger en envoyant un nouveau message avec le numéro du résultat (par exemple : `1`).
> Vous pouvez aussi télécharger plusieurs résultats en envoyant plusieurs numéros séparés par un espace (par exemple : `1 3 5`).
Si vous avez renseigné le chemin vers le dossier de téléchargement (`DOWNLOAD_PATH` dans le fichier .env), le bot téléchargera les fichiers dans ce dossier. Sinon, il ne vous enverra que le lien du torrent (vous pourrez utiliser une application comme [bittorrent](https://www.bittorrent.com/) pour le télécharger), et la fonctionnalité de téléchargement à partir de YouTube sera désactivée.
> Pour la recherche de torrents manuelle, vous pouvez vous rendre sur le puissant site [bt4g](https://bt4g.org/), qui permet de rechercher des torrents sur plusieurs sites de torrents en même temps.
## Licence
MIT © [Johan](https://johanstick.fr)