Telegram bot written in Node.js for downloading videos and image galleries from the internet and serving them as native media in Telegram. Uses yt-dlp for videos and gallery-dl for image galleries. Ensures privacy as users do not need to visit websites to download content.
- Supports Telegram groups. (/dl [URL] command)
- Original message deletion.
- Converts videos to MP4 automatically.
- Image gallery downloads (Instagram carousels, Reddit galleries, etc.) via gallery-dl.
- Automatic detection — tries video first, falls back to gallery.
- Whitelisting domains for automatic downloading in groups.
- Multiple media downloads from single message.
-
Clone the repository:
git clone https://github.com/Nikamura/klaid-bot.git
-
Navigate to the project directory:
cd klaid-bot/ -
Install dependencies:
pnpm install
-
Set up your environment variables (refer to .env.example for required keys).
-
Start the bot:
pnpm run start
- Start chat with Telegram bot.
- Send bot a video or gallery link.
- Receive the media!
or
- Add Telegram bot to your group chat.
- Send a command /dl (or /download) [URL] [URL] or a message with whitelisted domains.
- Receive the video or gallery!
- optional Set
KLAID_STORAGE_CHAT_IDto a private channel or group the bot can post in. Inline downloads are uploaded there briefly, so inline mode also works for people who never started the bot. - optional Make Bot user an admin in your group chat for request message cleanup and for download status and failure notices that only the person who posted the link can see.
Pull requests are welcome. For major changes, please open an issue first to discuss what you would like to change.
This project is open-source and available under the MIT License.
Built with passion by Karolis Mazukna.