explaingit

roxybasicneedbot/file-rename-4gb-bot-auto-rename-bot

11PythonAudience · developerComplexity · 3/5ActiveSetup · hard

TLDR

Python Telegram bot that renames files up to 4GB using a Pyrogram premium session, with thumbnails, FFmpeg video tools, NSFW scanning, and TMDb lookups.

Mindmap

mindmap
  root((roxy-rename-bot))
    Inputs
      Telegram files
      Custom thumbnails
      Caption templates
    Outputs
      Renamed files
      Converted videos
      Extracted audio
    Use Cases
      Channel file curation
      Subtitle muxing
      Video compression
    Tech Stack
      Python
      Pyrogram
      FFmpeg
      MongoDB

Things people build with this

USE CASE 1

Run a Telegram channel bot that auto-renames files with prefix and suffix rules

USE CASE 2

Mux external SRT or ASS subtitles into MKV or MP4 videos

USE CASE 3

Extract audio tracks from videos to MP3 or M4A

USE CASE 4

Add watermarks and metadata tags to videos before forwarding them

Tech stack

PythonPyrogramFFmpegMongoDB

Getting it running

Difficulty · hard Time to first run · 1h+

Needs a bot token, API credentials, a Pyrogram premium string session for 4GB uploads, and a MongoDB instance.

In plain English

Roxy Rename Bot is a Telegram bot written in Python that renames files for users inside Telegram chats. The headline trick is that it can handle files up to 4 gigabytes, well above Telegram's normal 2 gigabyte upload limit, by using a Pyrogram Premium user string session in addition to the usual bot token, API ID, and API hash. The README is heavy on visuals and badges, but the actual feature list is concrete. The rename engine is multi threaded, so it processes several rename jobs at once. Users can save custom thumbnails as jpg or png files that get bound to renamed outputs, set dynamic captions that include placeholders like filename, filesize, duration, and extension, and apply automatic prefixes or suffixes to every file that goes through. Alongside renaming, the bot bundles a set of video tools driven by FFmpeg. It can mux external subtitle files in srt or ass format into mkv or mp4 videos, trim clips to specific start and end timestamps, extract audio tracks into mp3 or m4a, compress videos to smaller sizes, and burn text or logo watermarks onto the output. There is also a metadata editor for tags like title, artist, album, description, and copyright. A few smart filters round out the automation. Custom extension autorename rules let users skip prompts for known file types. A NSFW scanner calls Hugging Face models to flag sensitive images and clips. A TMDb integration fetches descriptions, cover art, cast lists, and ratings for movie files automatically. Deployment is aimed at bot operators rather than end users. The bot stores its data in MongoDB and exposes an admin dashboard for monitoring resource use and activity, a multi channel force subscription gate that blocks usage until users join up to two Telegram channels, and tiered subscription options for grouping users. To run it you need a bot token from BotFather, API credentials, and a premium string session for the 4GB upload feature.

Copy-paste prompts

Prompt 1
Walk me through deploying Roxy Rename Bot with my BotFather token, API ID, API hash, and Pyrogram premium session
Prompt 2
Show me how to configure custom caption placeholders like filename and filesize in this bot
Prompt 3
Explain how the 4GB upload limit works with a Pyrogram user string session
Prompt 4
Help me wire up MongoDB and the force-subscription channel gate for this bot
Open on GitHub → Explain another repo

Generated 2026-05-22 · Model: sonnet-4-6 · Verify against the repo before relying on details.