How mhm-hossein/mewvia works
Mewvia is a Telegram media-toolbox bot. Users send media or choose a feature; handlers identify the operation, invoke media processing, and return results through Telegram. The product also includes personal sticker packs, download/search, group-media assistance, games and an admin panel. The README documents the broad feature flow; sampled handlers and the source index support several internal links. Unsampled feature implementations are represented only where the tree or README establishes them.
Main entry points: media Specialized media tools · admin/router.py Admin panel · convert/router.py Media conversion · batch/router.py Batch processing
Components 31
Bot runtime
- Polling runtime
app/__main__.py - Feature registry
app/features/registry.py
User features
- Media conversion
app/features/convert/router.py - Batch processing
app/features/batch/router.py - Audio tools
app/features/audio/router.py - Video tools
app/features/videotools/router.py - Sticker packs
app/features/stickerpack/router.py - Media downloader
app/features/downloader/router.py - Music search
app/features/music_search/router.py - Shazam lookup
app/features/shazam/router.py - Tag editor
app/features/tag_editor/router.py - Media filters
app/features/filters/router.py - Group media helper
app/features/group_media/router.py - Games
app/features/games/router.py
Media processing
- Media detection
app/media/kinds.py - Conversion pipeline
app/media/pipeline.py - Specialized media tools
app/media - Image and frame tools
app/media/image_tools.py
Shared platform
- PostgreSQL
app/db/session.py - Data repositories
app/db/repo - Redis cache
app/cache/redis.py - Group panel guard
app/middlewares/group_guard.py - UI kit
app/ui/kb.py - Daily quota
app/core/quota.py - Sponsor gate
app/middlewares/sponsor_gate.py - Runtime settings
app/core/settings_store.py
Administration
- Admin panel
app/admin/router.py - Backup tools
app/admin/backup.py - Broadcast and exports
app/admin/broadcast.py
Other components
- Telegram user
- Telegram Bot API
Connections 37
- Telegram user → Telegram Bot API: sends media
- Telegram Bot API → Polling runtime: delivers updates
- Polling runtime → Feature registry: attaches features
app/features/registry.py - Telegram user → Media conversion: requests conversion
- Media conversion → Media detection: identifies media
- Media conversion → Conversion pipeline: requests conversion
- Conversion pipeline → Telegram Bot API: returns result
- Telegram user → Audio tools: chooses audio tool
- Telegram user → Video tools: chooses video tool
- Telegram user → Sticker packs: manages packs
- Sticker packs → Data repositories: uses repositories
app/features/stickerpack/router.py - Telegram user → Media downloader: requests download
app/features/downloader/router.py - Media downloader → Specialized media tools: uses downloader
app/features/downloader/router.py - Telegram user → Music search: searches music
app/features/music_search/router.py - Music search → Specialized media tools: uses search tools
app/features/music_search/router.py - Telegram user → Shazam lookup: requests recognition
- Telegram user → Batch processing: requests batch work
app/features/batch/router.py - Batch processing → Media detection: classifies media
app/features/batch/router.py - Batch processing → Specialized media tools: uses chained processing
app/features/batch/router.py - Telegram user → Tag editor: edits metadata
app/features/tag_editor/router.py - Telegram user → Media filters: applies filters
- Telegram user → Group media helper: uses group panel
- Telegram user → Games: plays games
- Telegram user → Image and frame tools: uses image tools
- Audio tools → Specialized media tools: uses audio tools
app/features/audio/router.py - Video tools → Specialized media tools: uses video tools
app/features/videotools/router.py - Specialized media tools → Conversion pipeline: uses conversion core
app/media/chained_pipeline.py - Group panel guard → Redis cache: stores panel state
app/middlewares/group_guard.py - Group panel guard → Media detection: resolves panel media
app/media/kinds.py - Daily quota → Runtime settings: reads quota setting
app/core/quota.py - Daily quota → PostgreSQL: counts conversions
app/core/quota.py - UI kit → Telegram Bot API: builds bot keyboards
app/ui/kb.py - Sponsor gate → Telegram user: checks membership
app/middlewares/sponsor_gate.py - Admin panel → Backup tools: delegates backup
app/admin/router.py - Admin panel → Broadcast and exports: delegates broadcast
app/admin/router.py - Admin panel → Data repositories: uses repositories
app/admin/router.py - Data repositories → PostgreSQL: queries database