Skip to content

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

License

Notifications You must be signed in to change notification settings

Aluval/ReNameXBot

Folders and files

NameName
Last commit message
Last commit date

Latest commit

 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 

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

Watchers

Forks

Releases

No releases published

Languages