Universal Downloader Bot

A Telegram bot that downloads video and audio from Instagram and YouTube links — no watermarks, no ads.

---

Features

• Instagram — Reels, posts, IGTV
• YouTube — video (up to 1080p) and audio-only (MP3)
• Async download queue, so several users are served concurrently
• Automatic cleanup of temporary files
• Uzbek / English interface
• Per-user rate limiting

How it works

User sends link
      |
      v
 URL parser --> platform router --> yt-dlp extractor
                                          |
                                    format selection
                                          |
                                    download -> temp
                                          |
                              size check -> Telegram upload
                                          |
                                      cleanup

Repository layout

bot.py              # aiogram entrypoint, handlers
downloaders/
  instagram.py
  youtube.py
utils/
  validators.py     # URL parsing and platform detection
  cleanup.py
locales/            # uz / en interface strings
requirements.txt

Configuration

Variable	Description
BOT_TOKEN	Token from BotFather
MAX_FILE_MB	Upload size cap (Telegram limit: 50 MB for bots)
DOWNLOAD_DIR	Temporary download path
ADMIN_ID	Telegram user ID that receives error reports

Legal note

Intended for downloading content you own or that is licensed for reuse. Users are responsible for complying with the terms of service of the source platform and with applicable copyright law.

Author

Mardonbek Sulaymonqulov — AI / Computer Vision Engineer GitHub · mardonbeksulaymonqulov156@gmail.com