Skip to content

README.md

Latest commit

 

History

History
290 lines (249 loc) · 11.4 KB

README.md

File metadata and controls

290 lines (249 loc) · 11.4 KB

Shobana Filter Bot

A powerful and versatile Telegram bot designed for filtering, automation, and much more!

✨ Features

  • ✅ Auto Filter
  • ✅ Manual Filter
  • ✅ IMDB Search and Info
  • ✅ Admin Commands
  • ✅ Broadcast Messages
  • ✅ File Indexing
  • ✅ Inline Search
  • ✅ Random Pics Generator
  • ✅ User and Chat Stats
  • ✅ Ban, Unban, Enable, Disable Commands
  • ✅ File Storage
  • ✅ Auto-Approval for Requests
  • ✅ Shortener Link Support (/short)
  • ✅ Feedback System
  • ✅ Font Styling (/font)
  • ✅ User Promotion/Demotion
  • ✅ Pin/Unpin Messages
  • ✅ Image-to-Link Conversion
  • ✅ Auto Delete: Automatically removes user messages after processing, so you don't need a separate auto-delete bot
  • ✅ Auto Restart
  • ✅ Keep Alive Function: Prevents the bot from sleeping or shutting down unexpectedly on platforms like Koyeb, eliminating the need for external uptime services like UptimeRobot.
  • ✅ /movies and /series Commands: Instantly fetch and display the most recently added movies or series with these commands.
  • ✅ Hyperlink Mode: When enabled, search results are sent as clickable hyperlinks instead of using callback buttons for easier access.
  • ✅ Multiple Request FSub support: You can add multiple channels. Easily update the required channels with the /fsub command, e.g., /fsub (channel1 id) (channel2 id) (channel3 id).
  • ✅ Delete Files by Query: Use the /deletefiles command to delete all files containing a specific word in their name. For example, /deletefiles predvd removes all files with 'predvd' in their filename.
  • ✅ Auto delete for files.
  • ✅ Channel file sending mode with multiple channel support.
  • ✅ SQL database (postgrasql) support (Optional).
  • ✅ 5 MongoDb support (optional).

Commands

start - Start the bot
movies - Latest added movies
series - Latest added series
connect - Connect group to PM
disconnect - Disconnect active chat
connections - Show your connections
settings - Open group settings
filter - Create manual filter
add - Create manual filter (alias)
filters - List filters
viewfilters - List filters (alias)
del - Delete filter
delall - Delete all filters
imdb - Search movie/series info
mnsearch - Search movie/series info (alias)
id - Show user / chat ID
info - Show user information
bug - Send bug report / feedback
bugs - Send bug report / feedback (alias)
feedback - Send feedback (alias)
search - Search from external sources
paste - Create paste link
pasty - Create paste link (alias)
tgpaste - Create paste link (alias)
short - Shorten URL
tr - Translate replied text
font - Style your text
genpassword - Generate strong password
genpw - Generate strong password (alias)
tts - Text to speech
carbon - Generate carbon image
stickerid - Get sticker file ID
json - Show message JSON
js - Show message JSON (alias)
showjson - Show message JSON (alias)
img - Upload image and get link
cup - Upload image and get link (alias)
telegraph - Upload image and get link (alias)
share - Share text as link
share_text - Share text as link (alias)
sharetext - Share text as link (alias)
echo - Repeat the text
pin - Pin replied message
unpin - Unpin a message
unpin_all - Unpin all messages
promote - Promote a user in group
demote - Demote a user in group
stats - Show bot database statistics
invite - Generate group invite link
ban - Ban user from using the bot
unban - Unban user
leave - Make bot leave a chat
disable - Disable a chat
enable - Enable a disabled chat
deletefiles - Bulk delete indexed files
deleteall - Delete all indexed files
users - List bot users
chats - List connected chats/groups
channel - List indexed channels
broadcast - Broadcast message to users
grpbroadcast - Broadcast message to groups
logs - Get recent bot logs
delete - Delete one indexed file
fsub - Update force-subscribe channels
restart - Restart the bot
ping - Check bot ping
usage - Show resource usage
set_template - Set custom template
setskip - Set skip settings
clear_join_users - Clear join users data

🔧 Variables

Required

  • BOT_TOKEN: Obtain via @BotFather.
  • API_ID: Get this from Telegram Apps.
  • API_HASH: Also from Telegram Apps.
  • CHANNELS: Telegram channel/group usernames or IDs (space-separated).
  • ADMINS: Admin usernames or IDs (space-separated).
  • DATABASE_URI: Primary MongoDB URI (first priority if set).
  • DATABASE_NAME: Primary MongoDB database name.
  • DATABASE_URI2..DATABASE_URI5: Optional extra MongoDB URIs (up to 5 total) for sharded media indexing/search.
  • DATABASE_NAME2..DATABASE_NAME5: Optional database names for those extra MongoDB URIs (defaults to DATABASE_NAME).
  • POSTGRES_URI: PostgreSQL connection URI used when DATABASE_URI is not set.
  • LOG_CHANNEL: Telegram channel for activity logs.

Database priority order

  1. DATABASE_URI (MongoDB)
  2. POSTGRES_URI (PostgreSQL SQL backend)

Optional

  • PICS: Telegraph links for images in start message (space-separated).
  • FILE_STORE_CHANNEL: Channels for file storage (space-separated).
  • POSTGRES_STORAGE_LIMIT_BYTES: Optional PostgreSQL quota for accurate /stats free storage in SQL mode (supports formats like 1073741824, 1024MB, 1GB).
  • Refer to info.py for more details.

🚀 Deployment (Beginner Friendly Full Guide)

This guide supports MongoDB or PostgreSQL:

  1. MongoDB (DATABASE_URI) with optional media shards (DATABASE_URI2..DATABASE_URI5)
  2. PostgreSQL (POSTGRES_URI) when MongoDB is not set.

1) Minimum environment variables

BOT_TOKEN=123456:ABC...
API_ID=1234567
API_HASH=xxxxxxxxxxxxxxxxxxxxxxxxxx
ADMINS=123456789
CHANNELS=-1001234567890
LOG_CHANNEL=-1001234567890

Then choose one DB method below.

2) MongoDB connection (recommended for beginners)

  1. Create account: https://www.mongodb.com/cloud/atlas/register
  2. Create cluster.
  3. Database Access → create DB user.
  4. Network Access → allow your server IP.
  5. Connect → Drivers → copy URI.
  6. Set environment values:
DATABASE_URI=mongodb+srv://<username>:<password>@cluster0.xxxxx.mongodb.net/?retryWrites=true&w=majority
DATABASE_NAME=Cluster0
COLLECTION_NAME=mn_files

Quick test:

from pymongo import MongoClient
uri = "mongodb+srv://<username>:<password>@cluster0.xxxxx.mongodb.net/?retryWrites=true&w=majority"
client = MongoClient(uri, serverSelectionTimeoutMS=5000)
print(client.admin.command("ping"))

3) PostgreSQL connection (exact format)

You need:

  • host
  • port (5432 usually)
  • database name
  • username
  • password

URI format:

postgresql+psycopg2://USERNAME:PASSWORD@HOST:5432/DATABASE_NAME

Example env:

POSTGRES_URI=postgresql+psycopg2://bot_user:StrongPass@your-host:5432/shobana_bot

Create DB/user manually:

CREATE DATABASE shobana_bot;
CREATE USER bot_user WITH ENCRYPTED PASSWORD 'StrongPass';
GRANT ALL PRIVILEGES ON DATABASE shobana_bot TO bot_user;

Quick test:

from sqlalchemy import create_engine, text
engine = create_engine("postgresql+psycopg2://bot_user:StrongPass@your-host:5432/shobana_bot")
with engine.connect() as c:
    print(c.execute(text("SELECT 1")).scalar())

Important:

  • Leave DATABASE_URI empty if using PostgreSQL.
  • Set POSTGRES_STORAGE_LIMIT_BYTES to your provider quota (examples: 1GB, 1024MB, or raw bytes) if you want /stats free storage to show DB quota-based remaining space.
  • Do not set MySQL/SQLite/Turso variables (not used in this repo now).

4) Where to deploy

  • Koyeb: easiest for beginners
  • Render
  • Railway
  • VPS (advanced)

For all platforms:

  1. Fork repo.
  2. Add env variables.
  3. Deploy.
  4. Verify bot with /start.

5) Common errors

  1. DATABASE_URI set but Mongo auth fails → recheck DB username/password and network access.
  2. PostgreSQL connection refused → check host/port/firewall/SSL requirements.
  3. Invalid PostgreSQL URI → ensure it starts with postgresql+psycopg2://.
  4. Bot not responding in channels → make bot admin in channels listed in CHANNELS.

💬 Support

Telegram Group Telegram Channel

🙏 Credits
  • Dan for the Pyrogram Library
  • Mahesh for the Media Search Bot
  • EvamariaTG for the EvaMaria Bot
  • Trojanz for Unlimited Filter Bot
  • Goutham for ping feature
  • MN TG for editing and modifying this repository(Currently It's Me)
  • If your intrested to Collab with us Just fork this repo and create pull request ------ Click Here To Fork Repo
📜 Disclaimer

GNU AGPLv3

This project is licensed under the GNU AGPL 3.0. Selling this code for monetary gain is strictly prohibited.