Skip to content

RknDeveloper/Rkn-AutoCaptionBot

Repository files navigation

⚠️ Note: This repo has been built with ruff error handling.
Please make any changes only after careful consideration — otherwise, it may lead to errors.

👉 Join your very own #RknFamily

logo

Auto Caption Bot

💜 Thanks for Being Here 💜

  • This bot automatically updates captions for videos, audios, and documents uploaded to your channel.


  • Deployment Methods
  • 📌 Deploy to Koyeb

    Deploy to Koyeb

    📌 Deploy to Render

    Deploy to Render

    📌 Deploy to Heroku

    📌 Deploy To Railway Deploy

    🥰 Features

    • Channel Auto Caption Edit.
    • Set Caption support.
    • Force join for the user for use.
    • Supports Broadcasts.
    • Unlimited Channel Support.
    • Has a custom Start-up pic.
    • Force subscribe available.
    • Admin Command Available.
    • Deploy to Koyeb + Heroku + Railway + Render + Vps.
    • Developer Service 24x7. 🔥

    🔧 Configuration Guide

    Set the following environment variables before deploying:

    • BOT_TOKEN
      Get it from @BotFather after creating your bot.

    • API_ID
      Available at my.telegram.org → Login and go to "API Development Tools or use bot @ApiScrapManBot to fetch easily".

    • API_HASH
      Available at my.telegram.org → Login and go to "API Development Tools or use bot @ApiScrapManBot to fetch easily".

    • ADMIN
      Telegram user ID(s) of the bot admin(s).
      ➤ For Do not add multiple admins — space-separated IDs are not supported.", Example: 123456789

    • DB_URL
      MongoDB connection URL.
      ➤ Get it from MongoDB Atlas.

    • DB_NAME
      Your MongoDB database name.
      Example: mybotdb

    • FORCE_SUB
      Telegram channel username without @.
      ➤ Used to force users to join your channel before using the bot. (only public chat username required) Example: MyChannel

    • DEFAULT_CAPTION
      Default caption for files sent by the bot.
      ➤ Use {filename} to insert the file name automatically.
      Example: <b>📂 File:</b> {filename}\n<b>🔗 Join:</b> @MyChannel

    Botfather Commands

    start - Bᴏᴛ Aʟɪᴠᴇ Cʜᴇᴄᴋɪɴɢ
    set_caption - To Set Your Custom Caption (This Commands Works On Channels Only)
    del_caption - To Delete Your Custom Caption (This Commands Works On Channels Only)
    restart - Tᴏ Rᴇsᴛᴀʀᴛ Tʜᴇ Bᴏᴛ (Aᴅᴍɪɴ ᴏɴʟʏ)
    status - ᴄʜᴇᴄᴋ ʙᴏᴛ sᴛᴀᴛᴜs (ᴀᴅᴍɪɴ ᴏɴʟʏ)
    broadcast - sᴇɴᴅ ᴍᴀssᴀɢᴇ ᴛᴏ ᴀʟʟ ᴜsᴇʀs (ᴀᴅᴍɪɴ ᴏɴʟʏ)
    

    Support

    • Telegram Updates
    • Telegram Support

    📜 License

    License: MIT

    This project is licensed under the MIT License.

    You are free to:

    • ✅ Use this code in your own projects
    • ✅ Modify or enhance it
    • ✅ Fork and share it
    • ✅ Use it commercially

    ⚠️ Under the following conditions:

    • 📝 You must include proper credit to the original author: RknDeveloper
    • 📄 You must retain the original LICENSE file
    • Do not claim this project as your own

    Example of credit:
    Project originally developed by RknDeveloper (https://github.com/RknDeveloper/Rkn-AutoCaptionBot)