{"id":13989116,"url":"https://github.com/yash-dk/Mesh-RenameBot","last_synced_at":"2025-07-22T10:31:02.890Z","repository":{"id":38891936,"uuid":"378952271","full_name":"yash-dk/Mesh-RenameBot","owner":"yash-dk","description":"One of the best Rename bot for telegram. Heroku deployable and many features.","archived":false,"fork":false,"pushed_at":"2025-02-06T15:03:32.000Z","size":156,"stargazers_count":118,"open_issues_count":0,"forks_count":286,"subscribers_count":4,"default_branch":"master","last_synced_at":"2025-02-06T15:40:37.623Z","etag":null,"topics":["bot","rename","telegram"],"latest_commit_sha":null,"homepage":"","language":"Python","has_issues":true,"has_wiki":null,"has_pages":null,"mirror_url":null,"source_name":null,"license":"gpl-3.0","status":null,"scm":"git","pull_requests_enabled":true,"icon_url":"https://github.com/yash-dk.png","metadata":{"files":{"readme":"readme.md","changelog":null,"contributing":null,"funding":null,"license":"LICENSE","code_of_conduct":null,"threat_model":null,"audit":null,"citation":null,"codeowners":null,"security":null,"support":null,"governance":null,"roadmap":null,"authors":null,"dei":null,"publiccode":null,"codemeta":null}},"created_at":"2021-06-21T14:07:49.000Z","updated_at":"2025-02-06T15:03:43.000Z","dependencies_parsed_at":"2022-07-14T08:31:01.960Z","dependency_job_id":"16c1dbcc-3527-4e5f-be6d-5fadacf27f26","html_url":"https://github.com/yash-dk/Mesh-RenameBot","commit_stats":null,"previous_names":[],"tags_count":1,"template":false,"template_full_name":null,"purl":"pkg:github/yash-dk/Mesh-RenameBot","repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/yash-dk%2FMesh-RenameBot","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/yash-dk%2FMesh-RenameBot/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/yash-dk%2FMesh-RenameBot/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/yash-dk%2FMesh-RenameBot/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/yash-dk","download_url":"https://codeload.github.com/yash-dk/Mesh-RenameBot/tar.gz/refs/heads/master","sbom_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/yash-dk%2FMesh-RenameBot/sbom","host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":266474997,"owners_count":23934854,"icon_url":"https://github.com/github.png","version":null,"created_at":"2022-05-30T11:31:42.601Z","updated_at":"2022-07-04T15:15:14.044Z","status":"online","status_checked_at":"2025-07-22T02:00:09.085Z","response_time":66,"last_error":null,"robots_txt_status":null,"robots_txt_updated_at":null,"robots_txt_url":"https://github.com/robots.txt","online":true,"can_crawl_api":true,"host_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub","repositories_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories","repository_names_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repository_names","owners_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners"}},"keywords":["bot","rename","telegram"],"created_at":"2024-08-09T13:01:31.708Z","updated_at":"2025-07-22T10:31:02.861Z","avatar_url":"https://github.com/yash-dk.png","language":"Python","funding_links":[],"categories":["Python"],"sub_categories":[],"readme":"# 🚀 Mesh Rename Bot\n\n**Mesh Rename Bot** is a powerful Telegram bot designed for **auto-renaming files** using **custom filters**. With some advanced features like **permanent thumbnails, multiple upload modes, queue management, and more**. Also, supports 7 different languages.\n\nThis bot is aimed to be **the best rename bot around**! 🏆✨\n\n---\n\n## ⚠️ Beta Release Notice\n- The bot is **still in beta**. Your feedback is valuable!  \n- **Report any bugs, issues, or feature requests** by filing an issue.  \n- The bot will **guide you** through setting up filters easily! 😊\n\n---\n\n## 🛠 Features\n✅ **Auto Rename** files based on **custom filters**  \n✅ **Permanent Thumbnail Support**  \n✅ **3 Different Upload Modes** (Same Format, Forced Document, Streamable Media)  \n✅ **2 Different Rename Modes** (With and Without Command)\n✅ **Queue System** to maintain consistent renaming speed ⚡  \n✅ **PostgreSQL Support** (Mongo Planned)  \n✅ **Track User Activity** 📊  \n✅ **Force Join** (Require users to join a specific channel before use)  \n✅ **Multi-language Support** 🌎  \n✅ **Admin Controls** to manage bot users  \n✅ **7 Different** languages supported (en, es, ar, hi, ko, zh, ru) \n\n---\n\n## Test the bot\n[Check on Telegram](https://t.me/MeshRenameBot)\n\n---\n\n## ☁️ Deploy to Heroku  \nDeploy your own instance of the bot on Heroku with one click!\n\n[![Deploy](https://www.herokucdn.com/deploy/button.svg)](https://heroku.com/deploy?template=https://github.com/yash-dk/Mesh-RenameBot)\n\n---\n\n## 🔍 Filters Explained\n**Filters** can be managed using the `/filters` command.\n\n### 🏷 **Addition Filter**\n➕ Adds **specific text** to the **beginning or end** of the file name.  \n\n### ❌ **Remove Filter**\n🚫 Removes **specific text** from the file name **if present**.  \n\n### 🔄 **Replace Filter**\n🔁 Replaces **a specific text** with a **new text**.\n\n---\n\n## ⚙️ Configuration Variables\nModify the `config.py` file inside `MeshRenameBot` to **update settings \u0026 commands**.\n\n| Variable Name       | Description |\n|--------------------|-------------|\n| `DB_URI` | **Database URL** (PostgreSQL) |\n| `API_HASH` | **Telegram API HASH** |\n| `API_ID` | **Telegram API ID** |\n| `BOT_TOKEN` | **Bot Token** (from @BotFather) |\n| `COMPLETED_STR` | **Completed Symbol Marker** |\n| `REMAINING_STR` | **Remaining Symbol Marker** |\n| `MAX_QUEUE_SIZE` | **Maximum concurrent rename tasks** (default: 5) |\n| `SLEEP_SECS` | **Sleep time before editing messages** (default: 10 sec) |\n| `IS_PRIVATE` | **Set bot to private mode** |\n| `AUTH_USERS` | **List of allowed users** (works only when `IS_PRIVATE` is enabled) |\n| `OWNER_ID` | **Owner's Telegram User ID** |\n| `FORCEJOIN` | **Public group/channel username or invite link** (leave blank to disable) |\n| `FORCEJOIN_ID` | **Chat ID for `FORCEJOIN`** |\n| `TRACE_CHANNEL` | **Tracking Channel ID** (set `0` to disable tracking) |\n| `SAVE_FILE_TO_TRACE_CHANNEL` | **Save user file to tracking channel** |\n| `DEFAULT_LOCALE` | **Default Lnaguage of Bot** (values can be en, es, ar, hi, ko, zh, ru) |\n\n---\n\n## 📜 Commands List\nUse these commands to interact with the bot:\n\n| Command | Description |\n|---------|-------------|\n| `/start` | ✅ **Check if the bot is running** |\n| `/rename` | ✍️ **Rename a file** (`/rename filename.extension`) |\n| `/filters` | ⚙️ **Manage rename filters** |\n| `/setthumb` | 📷 **Set a permanent thumbnail** (Reply to an image) |\n| `/getthumb` | 📸 **Retrieve the current thumbnail** |\n| `/clrthumb` | ❌ **Clear the set thumbnail** |\n| `/mode` | 🔄 **Change upload and/or rename mode** (Same Format, Document, General Media) |\n| `/queue` | 📊 **View rename queue status** |\n| `/setcaption` | 📝 **Set a caption for the renamed files** |\n| `/setlang` | 🌐 **Change the bot's language.** |\n\n\n### 🔄 Upload Modes:\n- **Same format as sent** (Document remains Document, Video remains Video)\n- **Force to Document** (All uploads as files)\n- **General Media** (Streamable Video/Audio)\n\n---\n\n## 🖥 VPS Deployment Guide\nFor self-hosted deployment on a **VPS**, follow these steps:\n\n### 1️⃣ Install Dependencies  \n```bash\nsudo apt update \u0026\u0026 sudo apt install ffmpeg python3-pip\n```\n\n### 2️⃣ Clone the Repository\n```bash\ngit clone https://github.com/yash-dk/Mesh-RenameBot.git\ncd Mesh-RenameBot\n```\n\n### 3️⃣ Install Python Packages\n```bash\npip3 install -r requirements.txt\n```\n\n### 4️⃣ Run the Bot\n```bash\npython3 -m MeshRenameBot\n```\n\n## 🎖 Credits\n[Me](https://github.com/yash-dk)\n\n[Dan for Pyrogram](https://github.com/pyrogram/pyrogram)\n\n","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fyash-dk%2FMesh-RenameBot","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Fyash-dk%2FMesh-RenameBot","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fyash-dk%2FMesh-RenameBot/lists"}