Get a Telegram alert the instant a specific movie opens for booking at your chosen theatre and date.
Fork the repo to run your own independent watcher for a different movie or city.
Avoid running your own server by relying on GitHub Actions and a free external cron trigger.
Route around BookMyShow's block on non-Indian IP addresses using ScraperAPI.
| eziomj/movie-alert | 100/awesome-machine-learning | adam-s/car-diagnosis | |
|---|---|---|---|
| Stars | 8 | 8 | 8 |
| Language | Python | Python | Python |
| Last pushed | — | 2024-08-07 | — |
| Maintenance | — | Stale | — |
| Setup difficulty | moderate | easy | moderate |
| Complexity | 3/5 | 1/5 | 3/5 |
| Audience | general | developer | researcher |
Figures from each repo's GitHub metadata at analysis time.
Requires a Telegram bot token, a ScraperAPI key, and a GitHub personal access token before it works.
Movie-Alert watches BookMyShow, the Indian movie ticket booking site, and sends you a Telegram message the moment a specific movie, theatre, and date you care about opens for booking. It is meant for people trying to catch tickets the instant they go live, such as for a popular film or premiere. The whole thing runs for free using GitHub Actions instead of a server you have to keep running yourself. Because GitHub's own built in scheduler is not reliable enough for a ten minute check interval, the project relies on the free site cron-job.org to trigger the GitHub workflow every ten minutes from outside GitHub. When triggered, a Python script fetches the BookMyShow page through a service called ScraperAPI, which routes the request through an Indian IP address. This step is necessary because BookMyShow blocks requests coming from foreign or datacenter IP addresses, which is what GitHub's own servers use. The script checks whether your chosen movie, theatre, and date has switched from closed to open, and if it has, sends exactly one Telegram alert. It remembers what it last saw in a small state file so it does not send repeat alerts. Setting it up means creating a Telegram bot through BotFather, signing up for a free ScraperAPI key, adding both as secrets in your GitHub repository settings, and editing a configuration file with the movie, date, and theatre you want to watch. You also need a GitHub personal access token to let cron-job.org trigger your workflow. The project is designed to be forked, so anyone can copy it, add their own secrets and target, and run their own independent watcher and Telegram chat.
A free GitHub Actions bot that pings your Telegram the moment a chosen movie, theatre, and date opens for booking on BookMyShow.
Mainly Python. The stack also includes Python, GitHub Actions, Telegram Bot API.
Setup difficulty is rated moderate, with roughly 30min to a first successful run.
Mainly general.
This repo across BitVibe Labs
double-check against the repo, no cap.