Skip to content

Telegram bot designed to convert videos into round video messages.

License

Notifications You must be signed in to change notification settings

bohd4nx/Telegram-Video-Bot

Folders and files

NameName
Last commit message
Last commit date

Latest commit

 

History

2 Commits
 
 
 
 
 
 
 
 
 
 
 
 

Repository files navigation

📱 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+ GitHub license GitHub commits GitHub stars

🚀 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:

    git clone https://github.com/bohd4nx/Telegram-Video-Bot.git
    cd Telegram-Video-Bot
  2. Install FFmpeg:

    # Windows (using chocolatey)
    choco install ffmpeg
    
    # Ubuntu/Debian
    sudo apt-get install ffmpeg
    
    # macOS
    brew install ffmpeg
  3. Install the required dependencies:

    pip install -r requirements.txt
  4. Set Up Configuration:

    • Edit data/cfg.py
    • Add your bot token from @BotFather
    • Set admin ID (optional)
  5. Run the Bot:

    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