Skip to content

Aluval/ReNameXBot

Folders and files

NameName
Last commit message
Last commit date

Latest commit

 

History

259 Commits
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 

Repository files navigation

Typing SVG

logo

🫆 PUBLIC REPO 🫆

Deploy To Koyeb

Deploy to Koyeb

Deploy To Render

Deploy to Render

Deploy to Heroku

Press Below Button to Deploy!

Deploy

BOT INFO

ADD YOUR BOT TOKEN / CREDENTIALS IN config.py OR ENVIRONMENT VARIABLES

This Branch / Repo Supports: ReNameXBot — Rename, upload & manage files.

Behavior:

  • Files ≤ 2GB are re-uploaded to Telegram.

Features

  • Rename — Rename files/videos and re-upload them with a custom name.
  • Renamelink — Rename and re-upload directly from supported links (Pixeldrain, FastCloud, Workers.dev, Googleusercontent, Cloudflare - Workers.dev, Seedr, Heroku(SomeLinks) etc.) and display domain name for identification.
  • Settings — Per-user settings panel (screenshot toggle, count, prefix, rename type).
  • Thumbnail — Save & use custom thumbnails for uploads.
  • Screenshots — Auto-capture screenshots from videos (configurable count).
  • Tasks — Track rename/upload tasks (admin view with pagination).
  • Getfile — Retrieve previously saved/uploaded files.
  • Custom Caption / Prefix — Set caption text and prefix for uploaded files.
  • Admin — Remove tasks and clear old database collections.

𝑅𝐸𝑄𝑈𝐼𝑅𝐸𝐷 𝑉𝐴𝑅𝐼𝑀𝐴𝐵𝐿𝐸𝑆 (ENV / config.py)

  • BOT_TOKEN - Get bot token from @BotFather
  • API_ID - From my.telegram.org
  • API_HASH - From my.telegram.org
  • ADMIN - Admin Telegram ID (comma-separated allowed if extended)
  • MONGO_URL - MongoDB connection string (Atlas or local)
  • SUNRISES_PIC - Start / welcome picture (telegraph or https link)
  • INFO_PIC - Settings / info picture (telegraph or https link)
  • WEBHOOK - True or False (if using webhook deployment)
  • PORT - Port used for webhook deployments (e.g., 8080)
  • DOWNLOAD_DIR - Local downloads folder (default: downloads)

Example config.py env-vars used in this repo:

BOT_TOKEN = os.environ.get("BOT_TOKEN")
API_ID = os.environ.get("API_ID")
API_HASH = os.environ.get("API_HASH")
ADMIN = int(os.environ.get("ADMIN", "123456789"))
MONGO_URL = os.environ.get("MONGO_URL")
SUNRISES_PIC = os.environ.get("SUNRISES_PIC", "https://envs.sh/eer.jpg")
INFO_PIC = os.environ.get("INFO_PIC", "https://envs.sh/ees.jpg")
WEBHOOK = bool(os.environ.get("WEBHOOK", True))
PORT = int(os.environ.get("PORT", 8081))
DOWNLOAD_DIR = "downloads"

Commands (Core)

start - Bot alive check & welcome settings - Open settings panel (screenshot, count, prefix, type, thumb, caption) rename - Reply to a file + /rename <new_name> to rename & re-upload renamelink - Rename and re-upload directly from supported links tasks - List all tasks Pages (admin view available) getfile - /getfile (ownerfile) (or /getfile <user_id> (othersfile) to download stored files removetask - /removetask <user_id> <file.id> (Admin only) setprefix - /setprefix to set prefix setcaption - /setcaption to set custom caption clear - Clear database (Admin only) help - Get help about - Learn about the bot ping - Check bot latency stats - Bot usage info


Example Usage

  1. Rename a file
    • Reply to a document/video with:
      /rename new_name.mp4
      
    • Bot will download, rename, and re-upload the file.

2.Renamelink with DirectLink /renamelink <filename> <link>

  • Rename and re-upload directly from supported links (Pixeldrain, FastCloud, Workers.dev, Googleusercontent, Cloudflare - Workers.dev, Seedr, Heroku(SomeLinks) etc.)
  1. Set a custom prefix

/setprefix MyPrefix

  1. Save thumbnail
  • Send an image privately to the bot. The bot saves it as your thumbnail.
  1. Get a stored file

/getfile movie.mkv (OwnerFile) or /getfile userid movie.mkv(othersfile)

  • Bot searches your saved files and returns a match (case-insensitive, partial match supported).

File Storage & DB Collections

The bot stores user data in MongoDB. Typical collections:

  • settings — per-user settings (screenshot, count, prefix, rename_type)
  • thumbnails — saved thumbnail file_ids
  • captions — custom captions
  • tasks — user tasks (rename/upload tracking) - /removetask <user.id> <file.id>
  • user_files — stored file metadata { user_id, name, fileid }

Deployment Notes

  • For Webhook deployments (Koyeb / Render / Heroku) set WEBHOOK=True and provide PORT.
  • For long-running processes prefer hosting on a VPS / Docker with sufficient storage for downloads.
  • Ensure DOWNLOAD_DIR has enough disk space and is persisted between restarts if you want to keep files locally.

🔗 𝐂𝐨𝐧𝐭𝐚𝐜𝐓 𝐔𝐬!

Selling This Repo For Money Is Strictly Prohibited 🚫

THANK YOU ALL FOR THE SUPPORT 💫

𝗧𝗛𝗔𝗡𝗞𝗦 𝗧𝗢 𝗠𝗬 𝗧𝗘𝗟𝗨𝗚𝗨 𝗔𝗗𝗠𝗜𝗡𝗦 𝗙𝗢𝗥 𝗦𝗨𝗣𝗣𝗢𝗥𝗧 ❤️

About

A Telegram bot to rename files or direct download links with support for custom thumbnails, captions, prefixes, and automatic video screenshots.

Topics

Resources

License

Stars

6 stars

Watchers

0 watching

Forks

Releases

No releases published

Contributors

Languages