{"repo":"zerox9dev/Vidzilla","free":true,"listed":false,"github":"https://github.com/zerox9dev/Vidzilla","clone":"git clone https://github.com/zerox9dev/Vidzilla.git","description":"This Telegram bot allows users to download videos from various social media platforms including Instagram Reels, TikTok, YouTube, Facebook, Twitter, and Pinterest.","language":"Python","stars":68,"topics":["aiogram","async","facebook","nowatermark","telegram-bot","tiktok","webhook"],"license":null,"category":"self-hosted-apps","readme_excerpt":"Vidzilla 🤖 Telegram bot for downloading videos from social media — powered by self-hosted Cobalt. Features - Downloads videos from 8 platforms via Cobalt API - Sends each video in two formats: streamable video + original file - Proper aspect ratio and thumbnail (via ffprobe + ffmpeg ) - 50 MB cap (Telegram bot limit) with size pre-check - Per-user rate limiting - MongoDB for user/download tracking - Polling and webhook modes - /health endpoint and Docker healthcheck Supported platforms YouTube · Instagram · TikTok · Facebook · Twitter/X · Pinterest · Reddit · Vimeo (Cobalt actually handles 20+; bot filters by URL match — extend PLATFORM IDENTIFIERS in config.py to enable more.) Architecture Two containers, one docker network. Bot calls http://cobalt-api:9000/ , gets a media URL, streams it to disk with a 50 MB hard cap, sends to Telegram, cleans up. Quick start (Docker) Requires Docker + Docker Compose. Two containers come up: vidzilla-bot and cobalt-api . Environment Create .env in the project root: Local development (without Docker) Requires Python 3.11–3.13 and ffmpeg installed ( brew install ffmpeg on macOS, apt install ffmpeg on Linux). Python 3.14 is currently unsupported by pydantic-core builds — use 3.13. Bot commands - /start — welcome message - (any link) — paste a video URL, bot downloads and sends back How it works 1. User sends a URL → handlers/handlers.py routes by F.text.regexp(r'https?://') . 2. Platform detection by URL substring → config.py PLATFORM IDENTIF","default_branch":null,"files":null,"tree":[],"storefront":"/r/zerox9dev","claimed":false,"request_supported":{"post":"https://gitbuyer.com/r/zerox9dev/Vidzilla/request-supported","requests":0},"note":"indexed from public GitHub; nothing is for sale on this page. Clone it from GitHub. Paid listings live at /search."}