Run a Telegram channel bot that auto-renames files with prefix and suffix rules
Mux external SRT or ASS subtitles into MKV or MP4 videos
Extract audio tracks from videos to MP3 or M4A
Add watermarks and metadata tags to videos before forwarding them
Needs a bot token, API credentials, a Pyrogram premium string session for 4GB uploads, and a MongoDB instance.
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.
Generated 2026-05-22 · Model: sonnet-4-6 · Verify against the repo before relying on details.