https://github.com/vgvr0/telegram-youtube-twitter-tiktok-downloader
A Telegram bot that downloads and compresses media from YouTube, Twitter/X, and TikTok, with real-time progress updates and automatic compression for large files
https://github.com/vgvr0/telegram-youtube-twitter-tiktok-downloader
audio-extractor telegram-bot telegrambot-python tiktok-downloader tiktok-video-downloader twitter-downloader twitter-video-downloader youtube-downloader youtube-video-downloader yt-dlp
Last synced: 27 days ago
JSON representation
A Telegram bot that downloads and compresses media from YouTube, Twitter/X, and TikTok, with real-time progress updates and automatic compression for large files
- Host: GitHub
- URL: https://github.com/vgvr0/telegram-youtube-twitter-tiktok-downloader
- Owner: vgvr0
- Created: 2024-10-18T15:17:40.000Z (about 1 year ago)
- Default Branch: main
- Last Pushed: 2024-11-06T11:59:53.000Z (about 1 year ago)
- Last Synced: 2025-03-26T23:11:20.358Z (8 months ago)
- Topics: audio-extractor, telegram-bot, telegrambot-python, tiktok-downloader, tiktok-video-downloader, twitter-downloader, twitter-video-downloader, youtube-downloader, youtube-video-downloader, yt-dlp
- Language: Python
- Homepage:
- Size: 669 KB
- Stars: 1
- Watchers: 1
- Forks: 5
- Open Issues: 0
-
Metadata Files:
- Readme: README.md
Awesome Lists containing this project
README
### Telegram Media Downloader (Youtube, Twitter and TikTok):
**Telegram Media Downloader** is a Python-based bot designed to download videos and audios from platforms like YouTube, Twitter/X, and TikTok. If the file exceeds Telegram's 50 MB limit, it automatically compresses the file using `ffmpeg` and sends it to the user. This bot allows easy downloading and conversion of media through simple commands.
## 🎥 TeleDown Bot
Telegram Bot for downloading videos and audio from YouTube, Twitter/X and TikTok
[Report Bug](../../issues) |
[Request Feature](../../issues)
## 📱 Features
- 📥 Download videos from:
- YouTube
- Twitter/X
- TikTok
- 🎵 Audio extraction in MP3 format
- 📊 Real-time progress bar
- 🔄 Automatic format conversion
- 💾 Smart temporary storage management
- ⚡ Asynchronous processing for better performance
## 🚀 Installation
1. **Clone the repository**
```bash
git clone https://github.com/yourusername/teledown-bot.git
cd teledown-bot
```
2. **Create a virtual environment**
```bash
python -m venv venv
source venv/bin/activate # Linux/Mac
venv\Scripts\activate # Windows
```
3. **Install dependencies**
```bash
pip install -r requirements.txt
```
4. **Configure the bot**
- Get a token from @BotFather on Telegram
- Create a `.env` file based on `.env.example`
```env
API_TOKEN=your_token_here
TEMP_DOWNLOAD_FOLDER=/path/to/temp/folder
```
5. **Start the bot**
```bash
python bot.py
```
## 💡 Usage
### Available Commands
| Command | Description | Example |
|---------|-------------|---------|
| `/start` | Start the bot and show instructions | `/start` |
| `/video` | Download a video | `/video https://youtube.com/...` |
| `/audio` | Extract audio from a video | `/audio https://youtube.com/...` |
| `/help` | Show help and available commands | `/help` |
### Usage Examples
```plaintext
1. Download YouTube video:
/video https://youtube.com/watch?v=...
2. Extract audio from Twitter video:
/audio https://twitter.com/user/status/...
3. Download TikTok video:
/video https://tiktok.com/@user/video/...
```
## ⚙️ Configuration
### Environment Variables
| Variable | Description | Default Value |
|----------|-------------|---------------|
| `API_TOKEN` | Telegram Bot Token | - |
| `TEMP_DOWNLOAD_FOLDER` | Temporary folder | `./downloads` |
| `TELEGRAM_MAX_SIZE_MB` | Size limit | `50` |
## 🛠️ Technologies Used
- **Python 3.8+**
- **python-telegram-bot**: Telegram bot framework
- **yt-dlp**: Multimedia content download library
- **asyncio**: For asynchronous operations
## 📂 Project Structure
```
teledown-bot/
├── bot.py # Main bot code
├── requirements.txt # Project dependencies
├── .env # Environment variables
├── .gitignore # Files ignored by git
└── README.md # Documentation
```
## 🤝 Contributing
Contributions are welcome. Please:
1. Fork the project
2. Create a feature branch (`git checkout -b feature/AmazingFeature`)
3. Commit your changes (`git commit -m 'Add: new feature'`)
4. Push to the branch (`git push origin feature/AmazingFeature`)
5. Open a Pull Request
## 📝 License
Distributed under the MIT License. See `LICENSE` for more information.
## ⚠️ Limitations
- Maximum file size: 50MB (Telegram limit)
- Some videos may not be available for download
- Downloads depend on connection speed
## 📞 Support
- Open an [issue](../../issues) to report bugs
---