Skip to content

Latest commit

 

History

History
57 lines (38 loc) · 1.99 KB

README.md

File metadata and controls

57 lines (38 loc) · 1.99 KB
Raw

Marko Download Bot

This is a Telegram bot that receives URL to a video for popular sites like Instagram, TikTok, YouTube, etc. and responds with a downloaded video. It is convenient for sharing content with your friends and family.

GIF

Installation

  1. Create a new bot using Bot Father (https://t.me/BotFather). Remember your token
  2. Acquire API ID and Hash from https://my.telegram.org/apps. Remember them
  3. Clone this repository: git clone https://github.com/marko/MarkoDownloadBot.git
  4. Navigate to the project directory: cd MarkoDownloadBot
  5. Create file .env with this content:
TELEGRAM_API_ID=<api_id>
TELEGRAM_API_HASH=<api_hash>
TELEGRAM_BOT_API_TOKEN=<bot_token>
ADMIN_USERNAME=<your_telegram_username>
COOKIES_FILE=/path/to/your/cookies.txt
  1. Run the bot using docker compose: docker compose up -d
  2. Write /start to your new Telegram bot

Usage

The bot supports the following commands:

  1. Video Download: Simply send a URL to the bot, and it will download and send the video to you.

  2. /audio [URL]: Use this command followed by an audio URL to download and receive audio files.

  3. /stats: (Admin only) Provides basic usage statistics of the bot.

  4. /help or /start: Displays a help message with information about how to use the bot.

To download media, just send a valid video or audio link to the bot, and it will handle the rest!

Custom Cookies File

To use a custom cookies file with yt-dlp:

  1. Create a cookies file (e.g., cookies.txt) with the necessary cookies.
  2. Add the following line to your .env file: 
    COOKIES_FILE=/path/to/your/cookies.txt
  3. Restart the bot using docker compose up -d

If no custom cookies file is specified, an empty cookies file will be used by default.

Contributing

Contributions are welcome! If you have any ideas or improvements, feel free to submit a pull request.

License

This project is licensed under the MIT License. See the LICENSE file for more information.