Roxy Rename Bot Logo

π—₯𝗒𝗫𝗬 π—₯π—˜π—‘π—”π— π—˜ 𝗕𝗒𝗧

Redefining Telegram File Management & Automation.
It’s high-performance, feature-packed, and fully optimized for files up to 4GB.

Official Website β€’ Features β€’ Deploy β€’ Configuration β€’ Support

Roxy Rename Bot isn’t just another generic rename wrapper. It’s a fully custom-built Telegram automation bot with advanced media handling capabilities, because we think your files should be renamed, customized, and managed exactly the way you expect. If you want something that actually feels good to use, this is it.

[!IMPORTANT] System Requirements: A valid Telegram Bot Token from @BotFather, API ID, and API Hash are required. A Premium STRING_SESSION is mandatory for supporting files above 2GB up to 4GB.

✨ Features

⚑ Playback & Media Handling

    </p>
    <ul>
      <li>πŸ“‚ <b>Multi-Threaded Rename Engine:</b> Processes multiple renaming requests concurrently with low latency and high reliability.</li>
      <li>πŸš€ <b>4GB Super-Sized Uploads:</b> Uses custom Pyrogram Premium User string sessions to bypass Telegram's default 2GB upload limit.</li>
      <li>πŸ–ΌοΈ <b>Permanent Custom Thumbnails:</b> Save individual customized thumbnails (`.jpg`/`.png`) to bind to renamed files automatically.</li>
      <li>✍️ <b>Dynamic Custom Captions:</b> Embed placeholders like `{filename}`, `{filesize}`, `{duration}`, and `{ext}` into caption layouts.</li>
      <li>🏷️ <b>Automated Prefix & Suffix:</b> Configure static prefixes or suffixes to prepend or append to all renamed items.</li>
    </ul>
  </div>
</td>
<td width="50%" valign="top">
  <div align="left">
    <h3>🎬 Advanced Video Tools (FFmpeg Engine)</h3>
    <p>

    </p>
    <ul>
      <li>πŸ”€ <b>Multi-Format Subtitle Muxer:</b> Embed external SubRip (`.srt`) or Advanced SubStation Alpha (`.ass`) tracks directly into videos.</li>
      <li>βœ‚οΈ <b>Frame-Accurate Video Trimming:</b> Cut video files to precise lengths using start/end timestamp configurations.</li>
      <li>🎡 <b>Lossless Audio Extraction:</b> Separate and extract audio tracks from any video and save them as high-quality `.mp3`/`.m4a` files.</li>
      <li>πŸ—œοΈ <b>Smart Video Compressor:</b> Reduce file weights drastically while retaining crisp video fidelity.</li>
      <li>🎨 <b>Custom Video Watermarking:</b> Burn persistent text overlays or logos onto output files.</li>
    </ul>
  </div>
</td>

πŸ€– Automation & Smart Filters

    </p>
    <ul>
      <li>πŸ€– <b>Custom Extension Autorenaming:</b> Create custom rules based on format types to process inputs without prompts.</li>
      <li>πŸ“ <b>Metadata Injector & Editor:</b> Overwrite or embed title, artist, album, description, and copyright metadata tags.</li>
      <li>πŸ”ž <b>NSFW Content Scanner:</b> Uses Hugging Face API models to scan, detect, and filter out sensitive or adult images and clips.</li>
      <li>🍿 <b>TMDb Auto-Metadata:</b> Fetches descriptions, cover arts, casting details, and ratings automatically for movie files.</li>
    </ul>
  </div>
</td>
<td width="50%" valign="top">
  <div align="left">
    <h3>πŸ›‘οΈ Administration & Premium Management</h3>
    <p>

    </p>
    <ul>
      <li>πŸ“Š <b>Interactive Admin Dashboard:</b> Control systems, monitor live resource usage, and review real-time activity statistics.</li>
      <li>πŸ“’ <b>Multi-Channel Force Sub:</b> Block bot usage until users subscribe to up to two customizable Telegram channels.</li>
      <li>πŸ’³ <b>Tiered Subscription Options:</b> Group users into plans (Trial, Bronze, Silver, Gold, Platinum, Diamond) with custom limits.</li>
      <li>πŸ—‘οΈ <b>Auto-Delete Storage Saver:</b> Schedules automatic deletion of processed files to keep host resources clean.</li>
    </ul>
  </div>
</td>

πŸš€ DEPLOY ME

Koyeb Render
Deploy to Koyeb Deploy to Render
Railway Heroku
Deploy on Railway 
  </td>
</tr>

βš™οΈ ENVIRONMENT VARIABLES CONFIG (.env)

Deploy the bot locally or on cloud servers by setting up the environment. Copy .env.example to .env and fill in the parameters:

cp .env.example .env
Key Description
API_ID Your Telegram API ID from my.telegram.org (Required)
API_HASH Your Telegram API Hash from my.telegram.org (Required)
BOT_TOKEN Your Telegram Bot Token from @BotFather (Required)
DB_URL MongoDB connection URL (Required)
DB_NAME Database name (Default: Roxy_Rename_Bot)
ADMIN Telegram User IDs of administrators (Space-separated)
STRING_SESSION Premium session string for 4GB upload support (Optional)
FORCE_SUB Username or ID of the first force join channel (Optional)
FORCE_SUB2 Username or ID of the second force join channel (Optional)
TMDB_API_KEY TMDb API Key for movies auto-info (Optional)
NSFW_API_KEY HF API Key for adult filter (Optional)

πŸ–₯️ LOCAL RUN

Ensure Python 3.10+ and FFmpeg are installed on your machine.

  1. Install dependencies:
    pip install -r requirements.txt
  2. Start the bot:
    python bot.py

🀝 Acknowledgments

We stand on the shoulders of open-source giants:

  • Digital Rename Bot by DigitalBotz for the base project codebase.
  • Pyrogram / Pyrofork for the Telegram client framework.
  • FFmpeg for video processing engines.
Roxy Rename Bot Banner

If Roxy Rename Bot elevated your Telegram experience, please consider giving us a ⭐