NileshKavindaNaka

🎬 ffmpeg-video-bot - Your Easy Video Processing Assistant

📜 Overview

ffmpeg-video-bot is a powerful Telegram bot designed for video processing. It makes tasks like encoding, watermarking, and editing simple, even for those who aren’t tech-savvy. Whether you need to trim a video, merge clips, convert formats, or upload to Google Drive, this bot has you covered. Deploying it on your VPS using Docker is straightforward, making it accessible for individuals and groups alike.

🚀 Getting Started

Follow these easy steps to get your ffmpeg-video-bot up and running:

1. Download the Software

   Visit the Releases page to download the latest version of ffmpeg-video-bot. You will find the executable files available for download there.

2. Install Docker

   If you haven’t installed Docker yet, you need to do that first. Here’s a brief guide on how to install Docker based on your operating system:

   • Windows:
     • Go to the Docker Desktop website.
     • Download and install Docker Desktop.
     • Restart your computer once the installation is complete.
   • macOS:
     • Visit the Docker Desktop for Mac page.
     • Download the installer and follow the instructions to install.
   • Linux:
     • Open your terminal and enter the following commands according to your distribution.
     • For Ubuntu:

       sudo apt update
       sudo apt install docker.io
       

     • Ensure Docker is running with:

       sudo systemctl start docker
       sudo systemctl enable docker
       

3. Run ffmpeg-video-bot

   Once you have Docker installed, you can run the ffmpeg-video-bot.

   • Open your terminal or command prompt.
   • Navigate to the directory where you downloaded the bot.
   • Use the following command to start the bot:

     docker-compose up
     

4. Accessing Your Bot

   Now that the bot is running, head over to your Telegram app. Search for “ffmpeg-video-bot”, and start chatting with it to begin processing your videos.

📥 Download & Install

To download the latest version of ffmpeg-video-bot, simply visit the Releases page. There, you will find all the files you need. Click on the appropriate version for your setup.

1. Click the desired version.
2. Choose the file based on your operating system.
3. Save it to a location on your computer.

🔧 Features

• Video Processing: Encode, trim, merge, and convert videos with ease.
• Watermarking & Hardsubbing: Add watermarks or subtitles directly to your videos.
• Metadata Editing: Modify video details like titles and descriptions.
• Google Drive Upload: Seamlessly upload processed videos to your Google Drive.
• Multi-User Support: Use the bot with multiple users concurrently.

📋 System Requirements

To use ffmpeg-video-bot effectively, your system should meet the following requirements:

• Operating System: Windows 10 or higher, macOS Mojave or higher, or a recent version of a Linux distribution.
• Docker: Ensure you have the latest version of Docker installed.
• Internet Connection: A stable internet connection is required for Google Drive uploads and Telegram interaction.

🚨 Troubleshooting

If you encounter any issues, consider these common solutions:

• Bot Not Responding: Make sure the bot is running in your Docker environment. Use the command docker ps in the terminal to check active containers.
• Failed Uploads: Verify your internet connection and check if your Google Drive quota is not full.
• Video Format Issues: Ensure you are using standard video formats supported by FFmpeg.

👥 Community

Join our community on Telegram to discuss issues, share tips, or seek help. Engage with other users to enhance your experience with ffmpeg-video-bot.

📄 License

This project is licensed under the MIT License. You can use, modify, and distribute the software in accordance with this license.

For more insights about the bot or if you wish to contribute, please check the repository on GitHub. Your feedback and contributions are always welcome!