𝗥𝗢𝗫𝗬 𝗥𝗘𝗡𝗔𝗠𝗘 𝗕𝗢𝗧

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 📂 Multi-Threaded Rename Engine: Processes multiple renaming requests concurrently with low latency and high reliability. 🚀 4GB Super-Sized Uploads: Uses custom Pyrogram Premium User string sessions to bypass Telegram's default 2GB upload limit. 🖼️ Permanent Custom Thumbnails: Save individual customized thumbnails (`.jpg`/`.png`) to bind to renamed files automatically. ✍️ Dynamic Custom Captions: Embed placeholders like `{filename}`, `{filesize}`, `{duration}`, and `{ext}` into caption layouts. 🏷️ Automated Prefix & Suffix: Configure static prefixes or suffixes to prepend or append to all renamed items.

🎬 Advanced Video Tools (FFmpeg Engine) 🔀 Multi-Format Subtitle Muxer: Embed external SubRip (`.srt`) or Advanced SubStation Alpha (`.ass`) tracks directly into videos. ✂️ Frame-Accurate Video Trimming: Cut video files to precise lengths using start/end timestamp configurations. 🎵 Lossless Audio Extraction: Separate and extract audio tracks from any video and save them as high-quality `.mp3`/`.m4a` files. 🗜️ Smart Video Compressor: Reduce file weights drastically while retaining crisp video fidelity. 🎨 Custom Video Watermarking: Burn persistent text overlays or logos onto output files.

🤖 Automation & Smart Filters 🤖 Custom Extension Autorenaming: Create custom rules based on format types to process inputs without prompts. 📝 Metadata Injector & Editor: Overwrite or embed title, artist, album, description, and copyright metadata tags. 🔞 NSFW Content Scanner: Uses Hugging Face API models to scan, detect, and filter out sensitive or adult images and clips. 🍿 TMDb Auto-Metadata: Fetches descriptions, cover arts, casting details, and ratings automatically for movie files.

🛡️ Administration & Premium Management 📊 Interactive Admin Dashboard: Control systems, monitor live resource usage, and review real-time activity statistics. 📢 Multi-Channel Force Sub: Block bot usage until users subscribe to up to two customizable Telegram channels. 💳 Tiered Subscription Options: Group users into plans (Trial, Bronze, Silver, Gold, Platinum, Diamond) with custom limits. 🗑️ Auto-Delete Storage Saver: Schedules automatic deletion of processed files to keep host resources clean.

---

🚀 DEPLOY ME

Koyeb	Render
Railway	Heroku

---

⚙️ 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.

---

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