Skip to content

Latest commit

ย 

History

208 Commits

Folders and files

NameName
Last commit message
Last commit date
ย 
ย 
ย 
ย 
ย 
ย 
ย 
ย 
ย 
ย 
ย 
ย 
ย 
ย 
ย 
ย 
ย 
ย 
ย 
ย 
ย 
ย 
ย 
ย 
ย 
ย 

Repository files navigation

A powerful, open-source, and feature-rich Telegram bot designed to rename, customize, and transform files effortlessly with support for custom thumbnails, metadata, captions, and video conversion.

โšก Fast โ€ข ๐Ÿ“ Flexible โ€ข ๐Ÿ–ผ๏ธ Customizable

Last Commit
GitHub Stars GitHub Forks
Repo Size

divider

๐Ÿ“‘ Table of Contents


๐ŸŒธ Overview

Rename Bot is a powerful Telegram file management bot that goes far beyond simple renaming. It combines 4GB file support, premium plans, thumbnails, metadata, captions, and file conversion into one convenient Telegram-based workflow.

๐Ÿ’ก Take full control of your files with powerful customization tools.

๐Ÿค” Why Choose This Project?

  • โšก Fast & Powerful โ€” Process and rename files quickly with support for large files.
  • ๐ŸŽจ Highly Flexible โ€” Customize your files with powerful options tailored to your needs.
  • ๐Ÿ’Ž Premium Ready โ€” Built-in plans and premium features for enhanced capabilities.
  • ๐Ÿš€ Easy to Deploy โ€” Ready for self-hosting across multiple popular platforms.

๐Ÿ”„ How It Works

  1. ๐Ÿ“ค Send Your File โ€” Upload the file you want to rename or process.
  2. โš™๏ธ Choose Your Options โ€” Configure your filename and preferred customization settings.
  3. ๐Ÿ”„ Let the Bot Process โ€” The bot applies your selected settings automatically.
  4. ๐Ÿ“ฅ Get the Result โ€” Receive your customized file back through Telegram.

โœจ Features

  • โšก Fast File Renaming โ€” Rename files quickly with an efficient Telegram-based workflow.
  • ๐Ÿ“ฆ 4GB File Support โ€” Process large files with upgraded 4GB support.
  • ๐Ÿ’Ž Premium Plans โ€” Offer upgraded limits and premium capabilities for users.
  • ๐Ÿ–ผ๏ธ Thumbnail Customization โ€” Set permanent custom thumbnails for your files.
  • ๐Ÿ“ File Customization โ€” Personalize filenames, captions, prefixes, suffixes, and metadata.
  • ๐Ÿ”„ File Conversion โ€” Convert supported files between video and document formats.
  • โ™พ๏ธ Unlimited Renaming โ€” Rename multiple files without a fixed renaming limit.
  • ๐Ÿ“ข Broadcast System โ€” Send announcements and updates to all registered users.
  • ๐Ÿ” Force Subscribe โ€” Require users to join configured channels before using the bot.
  • ๐Ÿ›ก๏ธ User Management โ€” Ban, unban, and manage users directly from the bot.
  • ๐Ÿ”ง Maintenance Mode โ€” Temporarily pause bot services whenever maintenance is required.
  • ๐Ÿš€ Multi-Platform Deployment โ€” Deploy easily on Koyeb, Heroku, Railway, and Render.

๐ŸŽฅ Quick Start

New to this project?

Watch this short video to understand what the bot is, why it's useful, how it works, explore its key features, and learn the required configuration before deployment.

๐Ÿ“บ Watch on YouTube: Project Overview


๐Ÿ“ Configuration

Variable Description
API_ID Telegram API ID
API_HASH Telegram API Hash
BOT_TOKEN Telegram Bot Token
DB_URL MongoDB URI
ADMIN Telegram User ID
PICS Start Images
BIN_CHANNEL Bin Channel
IS_FSUB Enable / Disable Force Subscribe
FSUB_EXPIRE Force Subscribe Expire Time
AUTH_CHANNELS Force Subscribe Channels
AUTH_REQ_CHANNELS Request FSUB Channels
LOG_CHANNEL Log Channel
STRING_SESSION Session string required for 4GB file processing

๐Ÿ“ Notes

๐Ÿ’Ž 4GB Support โ€” STRING_SESSION is optional. Add a Pyrogram v2 String Session to enable 4GB file processing.

โš ๏ธ Without STRING_SESSION, the bot will continue to work with its standard file-size limit.

๐Ÿ“š Setup Guides


๐Ÿค– Commands

๐Ÿ‘ค User Commands
start - Check Bot Alive.
setprefix - Set Your Prefix
seeprefix - See Your Prefix
delprefix - Delete Your Prefix
viewthumb - To View Current Thumbnail.
delthumb - To Delete Current Thumbnail.
setcaption - To Set A Custom Caption.
seecaption - To See Your Custom Caption.
delcaption - To Delete Custom Caption.
setsuffix - Set Your Suffix
seesuffix - See Your Suffix
delsuffix - Delete Your Suffix
plans - to check all available plans.
myplan - to check your active plan.
metadata - To set custom metadata.
๐Ÿ”’ Owner Commands
ban - ban a user.
unban - unban a user.
banned - list all banned users.
status - get bot statistics.
broadcast - Send message to users.
logs - get recent bot logs.
addpremium - add a user to premium
removepremium - remove a user from premium
restart - restart the bot.
maintenance - Toggle maintenance mode.

divider

๐Ÿš€ Deployment

Need help deploying this project? We've got you covered.

Tip

๐Ÿ“บ Complete Deployment Playlist โ€” Follow the step-by-step video tutorials to get started.

โ–ถ Watch on YouTube


๐Ÿค Contributing

Contributions are always appreciated! โค๏ธ

๐Ÿž Report Bugs ๐Ÿ’ก Suggest Features ๐Ÿš€ Submit PRs
Found an issue? Have an idea? Ready to contribute?
Open Issue Open Discussion Fork & Submit

Important

Before opening an issue, please ensure you're using the latest version and have followed the deployment guide.


๐Ÿ“„ License

License

Warning

This project is intended strictly for educational purposes only. The author is not responsible for any misuse or abuse. Please comply with all applicable laws and the terms of any third-party services. If you modify or redistribute this project, please provide proper credit to the original repository.

See the LICENSE file for complete details.


๐Ÿซ‚ Updates & Support

Channel
Group


๐Ÿ™Œ Credits

This repository is based on the original work of:

Note

This repository is maintained by TechifyBots, with improvements to the project presentation and user experience.

divider

๐Ÿ‘ค Connect With Me

Rahul Dhankhar
Open Source Maintainer โ€ข TechifyBots


About

A Telegram File Renamer Bot With Permanent Thumbnail Support, Metadata Support, And Also It Can Convert Files Into Video With 4GB+ ๐Ÿ”ฅ

Resources

Stars

40 stars

Watchers

1 watching

Forks

Releases

Packages

Used by

Contributors

Languages