How botwalain/wholesomecitybot works
Lucia is a Telegram auto-filter bot: users search for a movie or series in chat or private messages, receive paginated file matches, then request a file; group owners configure search and access settings. Admins and moderators also index files, manage users and groups, and operate premium plans. The README additionally describes dual-database failover, subscription checks, streaming, trending and referral features. Edges reflect shown imports/calls or README descriptions; several plugin and storage behaviors are unsampled, so their internal links are omitted.
Main entry points: commands.py Commands · users_chats_db.py User And Group Store · bot.py Bot Startup · ia_filterdb.py File Catalog
Components 24
Bot Runtime
- Bot Startup
bot.py - Bot Client
Lucia/Bot/__init__.py - Client Pool
Lucia/Bot/clients.py - Bot Configuration
info.py - Message Templates
Script.py
File Search
- Search Handler
plugins/pm_filter.py - File Indexing
plugins/index.py - File Metadata
Lucia/util/file_properties.py
Storage And Accounts
- File Catalog
database/ia_filterdb.py - User And Group Store
database/users_chats_db.py - Referrals
database/refer.py - Search Trends
database/topdb.py
Bot Features
- Commands
plugins/commands.py - Premium Plans
plugins/Premium.py - Group Settings
plugins/settings.py - Subscription Checks
plugins/fsub_helper.py - Streaming And Download
plugins/route.py - Download Helper
Lucia/util/custom_dl.py - Verification
plugins/license.py - Channel Features
plugins/channel.py - Broadcast Admin
plugins/broadcast.py - Utility Commands
plugins/misc.py
Other components
- Telegram User
- Telegram API
Connections 29
- Telegram User → Bot Client: sends requests
README.md - Bot Startup → Bot Client: starts
bot.py - Bot Startup → Client Pool: initializes clients
bot.py - Bot Startup → File Catalog: loads
bot.py - Bot Startup → User And Group Store: loads
bot.py - Bot Startup → Bot Configuration: reads settings
bot.py - Bot Client → Commands: registers plugins
Lucia/Bot/__init__.py - Bot Client → Telegram API: uses API
Lucia/Bot/__init__.py - Search Handler → File Catalog: searches files
plugins/pm_filter.py - Search Handler → User And Group Store: reads settings
plugins/pm_filter.py - Search Handler → Message Templates: formats replies
plugins/pm_filter.py - File Indexing → File Catalog: indexes files
plugins/index.py - Commands → Search Handler: delegates queries
plugins/commands.py - Commands → Subscription Checks: checks access
plugins/commands.py - Commands → Referrals: uses referral data
plugins/commands.py - Commands → Search Trends: uses trend data
plugins/commands.py - Commands → File Catalog: manages files
plugins/commands.py - Commands → User And Group Store: manages accounts
plugins/commands.py - Commands → Group Settings: opens settings
README.md - Premium Plans → User And Group Store: updates plans
plugins/Premium.py - Group Settings → User And Group Store: stores settings
plugins/settings.py - Streaming And Download → Download Helper: uses downloader
plugins/route.py - Streaming And Download → Telegram API: serves media
- File Metadata → Telegram API: reads media
Lucia/util/file_properties.py - Verification → User And Group Store: checks account status
plugins/license.py - Channel Features → File Catalog: uses file catalog
plugins/channel.py - Broadcast Admin → User And Group Store: loads recipients
plugins/broadcast.py - Utility Commands → Telegram API: handles commands
- Bot Configuration → Message Templates: imports text
info.py