An open API service indexing awesome lists of open source software.

https://github.com/bohd4nx/telegram-video-bot

Telegram bot designed to convert videos into round video messages.
https://github.com/bohd4nx/telegram-video-bot

message send-video telegram telegram-bot telegram-bots video-bot video-message video-tools

Last synced: 8 months ago
JSON representation

Telegram bot designed to convert videos into round video messages.

Awesome Lists containing this project

README

          

๐Ÿ“ฑ Telegram Video Message Bot

### โญAbout the Project
This project is a Telegram bot designed to convert regular videos into round video messages (video notes). Perfect for creating engaging circular video messages that stand out in Telegram chats. Simply send a video, and the bot will handle the conversion automatically.

---

[![Python 3.9+](https://img.shields.io/badge/Python-3.9+-blue.svg)](https://www.python.org)
[![GitHub license](https://img.shields.io/github/license/bohd4nx/Telegram-Video-Bot.svg)](https://github.com/bohd4nx/Telegram-Video-Bot/blob/main/LICENSE)
[![GitHub commits](https://badgen.net/github/commits/bohd4nx/Telegram-Video-Bot)](https://github.com/bohd4nx/Telegram-Video-Bot/)
[![GitHub stars](https://badgen.net/github/stars/bohd4nx/Telegram-Video-Bot)](https://github.com/bohd4nx/Telegram-Video-Bot/)

### ๐Ÿš€ Features
- ๐ŸŽฅ Convert any video to round video message
- โšก Fast processing with optimized settings
- ๐Ÿ“ Automatic resizing and cropping
- ๐Ÿ”„ Easy-to-use interface
- ๐Ÿ“Š Admin statistics dashboard
- ๐Ÿ” Error tracking system

### ๐Ÿ‘จโ€๐Ÿ’ปInstallation:
1. **Clone the repository:**
```bash
git clone https://github.com/bohd4nx/Telegram-Video-Bot.git
cd Telegram-Video-Bot
```

2. **Install FFmpeg:**
```bash
# Windows (using chocolatey)
choco install ffmpeg

# Ubuntu/Debian
sudo apt-get install ffmpeg

# macOS
brew install ffmpeg
```

3. **Install the required dependencies:**
```bash
pip install -r requirements.txt
```

4. **Set Up Configuration:**
- Edit `data/cfg.py`
- Add your bot token from [@BotFather](https://t.me/BotFather)
- Set admin ID (optional)

5. **Run the Bot:**
```bash
python main.py
```

### ๐Ÿ“ฑ How to Use
1. Start bot with `/start`
2. Send any video file
3. Wait for processing
4. Receive round video message
5. Forward to any chat

### ๐Ÿ“ Video Requirements
- Format: MP4 (recommended)
- Duration: Up to 60 seconds
- Size: Max 20MB
- Quality: 480p recommended
- Aspect: Square videos work best

### โ—Contributions Welcome!

We welcome all forks, suggestions, and improvements to this project. Your contributions help make this project better for everyone. Whether it's fixing a bug, adding a feature, or improving documentation, we appreciate your help in making this project the best it can be.

### ๐Ÿ“ License
This project is MIT licensed. See LICENSE for more information.

### ๐ŸŒŸ Support
If you find this project useful:

- Give it a star โญ
- Share with others ๐Ÿ”„
- Consider contributing ๐Ÿ› ๏ธ

---


Built with โค๏ธ by Bohdan