How thenightlygod/lukidown_bot works
lukidown is a Telegram media-downloading bot. Users submit links or search queries, choose a format or quality, and receive downloaded media; Kinopoisk adds a browse-and-select flow. The bot coordinates platform detection, download routing, task services, and Telegram interactions. Major documented capabilities also include inline queries, music-search fallback, caching/history, cancellation, localization, and health checks. Some runtime wiring is only documented or appears in the source index, so uncertain relationships are omitted or marked unverified.
Main entry points: bot.py Bot handlers · router.py Download router · core.py Media engine · kinopoisk.py Kinopoisk browsing
Components 18
Bot interaction
- Bot handlers
bot.py - Platform detection
platforms.py - Translations
i18n.py
Download processing
- Download router
downloaders/router.py - Media engine
downloaders/core.py - Collection downloads
downloaders/collections.py - Kinopoisk browsing
downloaders/kinopoisk.py - Music handlers
downloaders - Media transcoder
downloaders/transcoder.py
Tasks and storage
- Task and history services
services.py - PostgreSQL
- Redis
Runtime support
- HTTP clients
downloaders/http.py - Configuration
config.py - Health server
health.py
Other components
- Telegram user
- Telegram
- Container orchestrator
Connections 22
- Telegram user → Bot handlers: sends requests
README.md - Bot handlers → Telegram: replies with media
README.md - Bot handlers → Platform detection: detects links
bot.py - Bot handlers → Download router: requests downloads
README.md - Download router → Platform detection: routes by platform
downloaders/router.py - Download router → Media engine: downloads media
downloaders/router.py - Download router → Collection downloads: downloads collections
downloaders/router.py - Download router → Kinopoisk browsing: dispatches requests
downloaders/router.py - Download router → Music handlers: dispatches requests
downloaders/router.py - Download router → Media transcoder: compresses media
downloaders/router.py - Kinopoisk browsing → Media engine: uses download engine
downloaders/kinopoisk.py - Kinopoisk browsing → HTTP clients: fetches service data
downloaders/kinopoisk.py - Media engine → HTTP clients: uses HTTP clients
downloaders/core.py - Music handlers → Media engine: uses download engine
downloaders/router.py - Music handlers → HTTP clients: fetches platform data
downloaders/core.py - Bot handlers → Task and history services: manages tasks and history
bot.py - Task and history services → PostgreSQL: reads and writes
services.py - Task and history services → Redis: queues and cancels
services.py - Bot handlers → Translations: renders localized text
bot.py - Bot handlers → Health server: starts health server
bot.py - Container orchestrator → Health server: checks health
README.md - Configuration → Bot handlers: configures runtime
bot.py