How kkleytt/cinema-bot works
This repository is a Russian-language Telegram film-discovery bot, with a desktop film-data entry/parser tool alongside it. The main workflow is a Telegram user choosing a search or recommendation criterion, receiving film details and viewing links, then optionally saving or marking a film as watched. The README also describes favorites, filtering, and a continuing random-selection feed. Bot handlers and SQLite access are concentrated in bot/main.py; misc/misc.py provides database setup and search helpers. The desktop tool’s parsing flow is visible, but its relationship to the bot’s runtime catalog is not established by the excerpts.
Main entry points: main.py Bot runtime · kb.py Inline menus · prs.py Metadata parser · misc.py Film catalog
Components 19
Telegram experience
- Bot runtime
bot/main.py - Inline menus
keyboards/kb.py - Bot copy
textbot/text_bot.py - Film search
bot/main.py - Film recommendations
bot/main.py - Catalog filtering
bot/main.py - Film details
bot/main.py - Viewing links
bot/main.py - Favorites
bot/main.py - Viewing history
bot/main.py - User records
misc/misc.py - Film catalog
misc/misc.py
Film catalog tools
- Catalog editor
parser/app.py - Metadata parser
parser/prs.py - Link-list parser
parser/parser.py - Catalog generation
parser/generate.py
Shared bot support
- Search helpers
misc/misc.py
Other components
- Telegram user
- Film information services
Connections 17
- Telegram user → Bot runtime: interacts with
README.md - Bot runtime → Inline menus: uses menus
bot/main.py - Inline menus → Bot copy: uses labels
keyboards/kb.py - Bot runtime → Film search: handles search
README.md - Bot runtime → Film recommendations: offers selection
README.md - Bot runtime → Catalog filtering: filters films
README.md - Bot runtime → Film details: shows details
bot/main.py - Bot runtime → Viewing links: provides links
README.md - Bot runtime → Favorites: saves favorites
README.md - Bot runtime → Viewing history: tracks watched
README.md - Bot runtime → User records: writes user data
bot/main.py - Bot runtime → Film catalog: reads film data
misc/misc.py - Bot runtime → Search helpers: uses search helpers
bot/main.py - Catalog editor → Metadata parser: parses metadata
parser/app.py - Metadata parser → Film information services: requests film data
parser/prs.py - Link-list parser → Film catalog: checks existing links
parser/parser.py - Catalog generation → Film information services: fetches metadata
parser/generate.py