How ffariseee-ux/movie-alert works
Movie-Alert periodically checks configured BookMyShow targets and alerts a Telegram chat when booking availability changes. The workflow begins with an external cron trigger, runs the poller, expands and validates movie/date targets, fetches each booking page, detects availability or newly added shows, and tracks last-seen state. The README also documents date-wide and venue-specific detection, optional proxy routing, and show/session monitoring. The graph reflects the documented runtime; source excerpts are partial, so some internal call ownership is not independently visible.
Main entry points: poller.py Booking-page fetch · booking-watch.yml Actions workflow · state.json Last-seen state · config.json Target configuration
Components 14
Scheduled runtime
- Actions workflow
.github/workflows/booking-watch.yml
Booking watcher
- Polling entrypoint
poller.py - Target configuration
config.json - Target preparation
poller.py - Booking-page fetch
poller.py - Availability detectors
poller.py - Change tracking
poller.py - Last-seen state
state.json - Alert message
poller.py
External services
- BookMyShow
- ScraperAPI
- India proxy
- Telegram
Other components
- Cron trigger
Connections 15
- Cron trigger → Actions workflow: dispatches
README.md - Actions workflow → Polling entrypoint: runs
README.md - Polling entrypoint → Target configuration: loads
poller.py - Polling entrypoint → Target preparation: prepares targets
poller.py - Target preparation → Booking-page fetch: supplies target URL
README.md - Polling entrypoint → Last-seen state: loads and updates
README.md - Booking-page fetch → ScraperAPI: routes requests
poller.py - ScraperAPI → BookMyShow: fetches page
README.md - Booking-page fetch → BookMyShow: fetches directly
poller.py - Booking-page fetch → India proxy: may route through
README.md - Booking-page fetch → Availability detectors: passes page text
poller.py - Availability detectors → Change tracking: reports availability
poller.py - Change tracking → Last-seen state: updates last-seen data
README.md - Change tracking → Alert message: triggers alert
poller.py - Alert message → Telegram: sends message
README.md