Url Uploader Bot

A feature-rich Telegram bot for downloading videos from YouTube and various other platforms using yt-dlp. Built with Pyrogram and MongoDB.

🌟 Features

Core Features

Multi-Platform Support: Download videos from YouTube, Instagram, Facebook, Twitter, and 1000+ sites
Format Selection: Choose from available video formats and resolutions
Smart File Splitting: Automatically splits large files (>1.75GB) to comply with Telegram limits
Custom Thumbnails: Set custom thumbnails for uploaded videos
Custom Captions: Add personalized captions to your downloads
Screenshot Generation: Generate multiple screenshots from downloaded videos
Sample Video Creation: Create 20-second preview clips

User Management

Two-Tier System: Regular and Student subscription plans
Daily Download Limits: Free users get 20 downloads per day
Force Subscribe: Require users to join channels before using the bot
User Database: Track users, settings, and download history

Admin Features

User Management: Ban/unban users, add paid subscriptions
Subscription Control: Set custom expiry dates for subscriptions
Broadcasting: Send messages to all users
Statistics: View paid users and their subscription details

📋 Prerequisites

Python 3.11+
MongoDB database
FFmpeg installed on system
Telegram Bot Token
Telegram API credentials (API_ID and API_HASH)

🚀 Installation

Method 1: Local Installation

Clone the repository

git clone <your-repo-url>
cd UrlUploaderCh

Install dependencies

pip install -r requirements.txt

Install FFmpeg

Ubuntu/Debian:

sudo apt update
sudo apt install ffmpeg

macOS:

brew install ffmpeg

Windows: Download from ffmpeg.org and add to PATH

Configure environment variables

Create a .env file in the root directory:

API_ID=your_api_id
API_HASH=your_api_hash
BOT_TOKEN=your_bot_token
MONGODB_URI=mongodb://localhost:27017
DB_NAME=ytdl_bot_db
ADMINS=your_user_id
PAID_USERS=
FORCE_SUB_CHANNEL1=DSRBotzz
FORCE_SUB_CHANNEL2=PaypalMafiaOfficial

Run the bot

python3 -m bot

Method 2: Docker Installation

Build the Docker image

docker build -t ytdl-bot .

Run with Docker

docker run -d \
  -e API_ID=your_api_id \
  -e API_HASH=your_api_hash \
  -e BOT_TOKEN=your_bot_token \
  -e MONGODB_URI=your_mongodb_uri \
  -e ADMINS=your_user_id \
  --name ytdl-bot \
  ytdl-bot

Method 3: Docker Compose

Create docker-compose.yml:

version: '3.8'

services:
  bot:
    build: .
    container_name: ytdl-bot
    environment:
      - API_ID=${API_ID}
      - API_HASH=${API_HASH}
      - BOT_TOKEN=${BOT_TOKEN}
      - MONGODB_URI=${MONGODB_URI}
      - ADMINS=${ADMINS}
      - FORCE_SUB_CHANNEL1=${FORCE_SUB_CHANNEL1}
      - FORCE_SUB_CHANNEL2=${FORCE_SUB_CHANNEL2}
    restart: unless-stopped
    depends_on:
      - mongodb

  mongodb:
    image: mongo:latest
    container_name: ytdl-mongodb
    ports:
      - "27017:27017"
    volumes:
      - mongodb_data:/data/db
    restart: unless-stopped

volumes:
  mongodb_data:

Run with:

docker-compose up -d

⚙️ Configuration

Environment Variables

| Variable | Description | Required | Default | |----------|-------------|----------|---------| | API_ID | Telegram API ID from my.telegram.org | Yes | - | | API_HASH | Telegram API Hash | Yes | - | | BOT_TOKEN | Bot token from @BotFather | Yes | - | | MONGODB_URI | MongoDB connection string | Yes | - | | DB_NAME | Database name | No | ytdl_bot_db | | ADMINS | Space-separated admin user IDs | Yes | - | | PAID_USERS | Space-separated paid user IDs | No | - | | FORCE_SUB_CHANNEL1 | First required channel username/ID | No | - | | FORCE_SUB_CHANNEL2 | Second required channel username/ID | No | - |

Configuration File (`bot/config.py`)

You can modify default settings in bot/config.py:

# Default Settings
DEFAULT_UPLOAD_MODE = "video"  # 'video' or 'file'
DEFAULT_SPLIT_SETTING = True   # Enable file splitting
DEFAULT_FORMAT = "bestvideo+bestaudio"

# File Size Limits (in bytes)
MAX_FILE_SIZE = int(1.75 * (1024 ** 3))  # 1.75GB

# Free users daily download limit
TASKS = 20

📱 Usage

User Commands

/start - Start the bot and see main menu
/help - Display help message with all commands
/settings - Configure bot settings
/clearthumbnail - Remove custom thumbnail
/caption <text> - Set custom caption
/clearcaption - Remove custom caption
/plans - View subscription plans
/upgrade - Check subscription status

Admin Commands

/broadcast <message> - Send message to all users
/ban <user_id> - Ban a user
/unban <user_id> - Unban a user
/addpaid <user_id> [duration] - Add paid subscription
- Example: /addpaid 123456789 30d (30 days)
- Example: /addpaid 123456789 3m (3 months)
- Example: /addpaid 123456789 1y (1 year)
/removepaid <user_id> - Remove paid status
/paidusers - List all paid users

How to Download

Send a video URL to the bot
Choose from available formats
Wait for download to complete
Receive your file(s)

Supported Platforms

The bot supports 1000+ websites through yt-dlp, including:

YouTube
Vimeo
Dailymotion
And many more...

💎 Subscription Plans

Regular Plan

1 Month: ₹30
3 Months: ₹85 (~5% discount)
6 Months: ₹160 (~11% discount)
1 Year: ₹300 (~16% discount)

Student Plan (Requires Verification)

1 Month: ₹10
3 Months: ₹28
6 Months: ₹53
1 Year: ₹100

Premium Features

Unlimited downloads (no daily limit)
File splitting for large videos
Custom thumbnail support
Custom caption support
Screenshot generation
Sample video creation
Priority support

🗂️ Project Structure

UrlUploaderCh/
├── bot/
│   ├── __init__.py
│   ├── __main__.py      # Main bot logic
│   ├── config.py        # Configuration
│   ├── database.py      # Database operations
│   └── yt_helper.py     # Download & processing utilities
├── downloads/           # Temporary download folder
├── .env                 # Environment variables
├── .gitignore
├── Dockerfile
├── docker-compose.yml   # (Optional)
├── requirements.txt
├── README.md
└── LICENSE

🔧 Troubleshooting

Common Issues

Bot doesn't respond:

Check if bot token is correct
Verify MongoDB connection
Check bot logs for errors

Downloads fail:

Ensure FFmpeg is installed
Check internet connection
Verify yt-dlp supports the URL

File upload errors:

Check file size (must be under 2GB for Telegram)
Enable file splitting in settings
Verify sufficient disk space

Thumbnail generation fails:

Ensure FFmpeg is properly installed
Check video file is not corrupted
Try without custom thumbnail

Debug Mode

Enable debug logging by modifying bot/__main__.py:

logging.basicConfig(
    level=logging.DEBUG,  # Change to DEBUG
    format='%(asctime)s - %(name)s - %(levelname)s - %(message)s'
)

📊 Database Schema

Users Collection

{
  user_id: Number,
  username: String,
  upload_mode: String,
  split_enabled: Boolean,
  caption: String,
  caption_enabled: Boolean,
  thumbnail: String,
  generate_screenshots: Boolean,
  generate_sample_video: Boolean,
  banned: Boolean,
  is_paid: Boolean,
  subscription_start: Date,
  paid_expiry: Date
}

URLs Collection

{
  url_id: String,
  url: String,
  user_id: Number,
  status: String,
  timestamp: Date
}

Daily Tasks Collection

{
  user_id: Number,
  date: String,
  count: Number
}

🤝 Contributing

Contributions are welcome! Please feel free to submit a Pull Request.

Fork the project
Create your feature branch (git checkout -b feature/AmazingFeature)
Commit your changes (git commit -m 'Add some AmazingFeature')
Push to the branch (git push origin feature/AmazingFeature)
Open a Pull Request

📝 License

This project is licensed under the MIT License - see the LICENSE file for details.

👨‍💻 Author

Nitin Sahay

Telegram: @NitinSahay
Channel: @ChronosBots

🙏 Acknowledgments

Pyrogram - Telegram MTProto API framework
yt-dlp - Video downloader
FFmpeg - Multimedia processing
MongoDB - Database

⚠️ Disclaimer

This bot is for educational purposes only. Users are responsible for ensuring they have the right to download and share content. The developers are not responsible for any misuse of this bot.

📞 Support

For support, join our Telegram channel @ChronosBots or contact @NitinSahay.

🔄 Updates

Check @ChronosBots for the latest updates and announcements.

Made with ❤️ by ChronosBots

UrlUploader

Install / Use

README