🎬 auto-filter-bot-v1

A powerful Telegram media search bot — search movies and files directly in PM or any group, with paginated results, auto-delete, broadcast, user tracking, and deep-link file delivery.

---

✨ Features

Feature	Description
💬 PM Search	Type any name → paginated file buttons → tap to receive instantly
👥 Group Search	Results shown in group → tap → file delivered to your PM via deep-link
🔗 Deep-Link Delivery	Group buttons use t.me/bot?start=<file_id> — works even if user never started bot
◀▶ Prev / Next Pages	AutoFilterBot-style pagination with live page counter
🗑 Auto-Delete	Files auto-delete after configurable time to avoid copyright issues
📌 Save Reminder	Users instructed to forward to Saved Messages before deletion
👤 User Tracking	Every /start user is saved to DB; new users trigger a log channel notification
📢 Broadcast	Send any message (text, photo, video, etc.) to all registered users
📡 Auto Index	New files posted in watched channels saved to DB instantly
🛠 Admin Commands	Full suite: /index, /setskip, /total, /users, /broadcast, /delete, /channel, /logs
🌐 Inline Mode	Search via @bot query in any chat
🔒 Force Subscribe	Optionally require users to join a channel before access
🌍 Always Alive	Built-in aiohttp web server — compatible with Render & Koyeb (no sleep)

---

🖼 Preview

Group Search

User: Kumki

Bot:
  🔎 Results for: Kumki
  📁 Found: 9 file(s)
  👇 Tap a file → you'll be taken to my PM where it will be sent!

  [1.59 GB]- 🎬 -Kumki 2 (2025) Tamil HQ HDRip 1080p HEVC x…
  [1.38 GB]- 🎬 -Kumki 2 (2025) Tamil HQ HDRip 720p x264 (D…
  [904.43 MB]- 🎬 -Kumki 2 (2025) Tamil HQ HDRip 720p HEVC …
  ──────────────────────────────────────────
  [🗂 1/2]   [NEXT ▶]

File Caption in PM

🎬 Kumki 2 (2025) Tamil HQ HDRip 1080p HEVC x265.mkv
📦 Size: 1.59 GB
🗂 Type: Video

⚠️ This file will be auto-deleted in 5 minute(s) to avoid copyright issues.
📌 Forward it to your Saved Messages to keep it forever!

[💾 Save to Saved Messages]

New User Notification in Log Channel

👤 New User Started Bot!

🆔 ID: 123456789
📛 Name: John Doe
🔗 Username: @johndoe
📅 Joined: 12 Mar 2026 • 10:45 UTC

👥 Total Users: 142

Broadcast Progress

📢 Broadcasting…

[████░░░░░░] 40%
Done: 400/1000

✅ Sent: 385
🚫 Blocked: 12  ← auto-removed from DB
❌ Failed: 3

[⛔ Cancel]

---

🚀 Deploy

Heroku

1. Click the button above
2. Fill in the required environment variables
3. Deploy — uses Procfile → worker: python main.py

Render / Koyeb

1. Connect your GitHub repo
2. Set Start Command: python main.py
3. Set Health Check URL: /health
4. Add all environment variables
5. Deploy — the built-in web server keeps the container alive permanently

Manual / VPS

git clone https://github.com/GouthamSER/auto-filter-bot-v1
cd auto-filter-bot-v1
pip install -r requirements.txt
cp sample.env .env
# Edit .env with your values
python main.py

---

⚙️ Environment Variables

Required

Variable	Description
API_ID	Get from my.telegram.org
API_HASH	Get from my.telegram.org
BOT_TOKEN	Get from @BotFather
DATABASE_URI	MongoDB connection string (e.g. mongodb+srv://...)
ADMINS	Space-separated Telegram user IDs — e.g. 123456 789012
CHANNELS	Space-separated channel IDs the bot watches — e.g. -100123 -100456
LOG_CHANNEL	Channel ID for bot logs + new user notifications

Optional

Variable	Default	Description
DATABASE_NAME	MediaSearchDB	MongoDB database name
COLLECTION_NAME	Telegram_files	MongoDB collection name
SESSION	MediaSearchBot	Pyrogram session name
MAX_RESULTS	10	Files shown per page
AUTO_DELETE_TIME	300	Seconds before file is deleted (300 = 5 min)
USE_CAPTION_FILTER	false	Also search inside file captions
AUTH_CHANNEL	—	Force users to join this channel ID before using bot
PORT	8080	Web server port (auto-set by Render/Koyeb)

Custom Messages (Optional)

Variable	Description
START_MSG	Custom welcome message. Supports {mention}, {username}, {first_name}
FORCE_SUB_MSG	Message shown when user hasn't joined AUTH_CHANNEL

---

🤖 Bot Commands

Everyone

Command	Description
/start	Welcome message + search buttons

Admins Only

Command	Description
/total	Total files saved in database
/users	Total registered users count
/broadcast	Send a message to all users (reply to any message, or inline text)
/cancelbroadcast	Stop a running broadcast mid-way
/channel	List all watched channels
/index <channel_id>	Bulk-index a channel (bot-only, no userbot needed)
/setskip <N>	Set message skip offset for /index (resume indexing)
/delete	Reply to any media → removes it from DB
/logs	Download the log file

---

📢 Broadcast Usage

Option 1 — Copy any message (photo, video, sticker, text…):

Reply to any message with /broadcast

Option 2 — Inline text only:

/broadcast 🎉 New movies added! Go search now!

Bot shows a preview with recipient count and Confirm / Cancel buttons before sending. Live progress updates during send. Blocked/deactivated users are automatically removed from the database.

---

🔍 Search Tips

• Basic: type any movie or file name in PM or any group
• Filter by type: movie name | video or song name | audio
• Inline anywhere: @YourBot movie name in any chat
• Pagination: tap ◀ PREV / NEXT ▶ to browse all results
• Group: results appear in the group; tapping a file delivers it to your PM

---

📁 Project Structure

auto-filter-bot-v1/
├── main.py                 ← Bot entry point + aiohttp web server
├── config.py               ← All configuration via environment variables
├── index.py                ← Standalone channel bulk-indexer (CLI)
├── requirements.txt
├── Procfile                ← Heroku: worker: python main.py
├── sample.env              ← Example environment variables
│
├── database/
│   ├── __init__.py
│   └── db.py               ← MongoDB motor (Media + Users collections)
│
└── plugins/
    ├── __init__.py
    ├── start.py            ← /start + deep-link file delivery + force-subscribe
    ├── search.py           ← PM & group search, pagination, auto-delete
    ├── inline.py           ← Inline mode search
    ├── channel.py          ← Auto-index new files from watched channels
    ├── users.py            ← User tracking + new user log channel notification
    ├── broadcast.py        ← /broadcast with live progress + cancel + auto-cleanup
    └── admin.py            ← Admin commands + bot-only channel indexer

---

🗄 Database Collections

Collection	Purpose
Telegram_files	All indexed media files (searchable)
users	All registered users — used for broadcast & analytics

---

🛠 Tech Stack

• Pyrogram v2 — Telegram MTProto client
• Motor — Async MongoDB driver
• aiohttp — Async web server (keep-alive for Render/Koyeb)
• MongoDB Atlas — Cloud database (free tier works)

---

👨‍💻 Credits

Role	Person
Maintainer & Rewritten By	GouthamSER
Original Concept	Media-Search-bot

---

📄 License

This project is licensed under the MIT License.

---

Made with ❤️ by GouthamSER