SeatSniper

Watch any BookMyShow page. Get a Discord DM the second tickets go on sale.
Self-host in one command. Bun + TypeScript + SQLite. No API keys, no credit card, no browser.

curl -fsSL https://raw.githubusercontent.com/Ishannaik/seatsniper/main/install.sh | bash

You tell it a BookMyShow link and a date. It polls the site, and the moment that date is bookable you get one DM. Say date:any instead and it pings you every time a new date unlocks or a new cinema starts showing the movie. Trim the noise with filters: format:IMAX,4DX only pings for those screens, and days:fri,sat only on those weekdays.

Works for movies, concerts, plays, any event BookMyShow lists in India.

It observes and notifies. It never buys tickets, holds seats, or fills carts.

• 🎯 Features
• 🚀 Quick start
• 🐳 Run with Docker
• 📦 Manual setup
• 🎮 Commands
• 🧠 How it works
• ⚙️ Configuration
• 🗺️ Project layout
• 🧗 BookMyShow quirks
• 🤝 Contributing

One command on Linux or macOS. It installs Bun, clones the repo, prompts for your Discord credentials, registers the slash commands, and starts the bot under pm2:

curl -fsSL https://raw.githubusercontent.com/Ishannaik/seatsniper/main/install.sh | bash

Non-interactive, for CI or a box with no terminal:

DISCORD_TOKEN=... DISCORD_CLIENT_ID=... bash <(curl -fsSL https://raw.githubusercontent.com/Ishannaik/seatsniper/main/install.sh)

Then:

1. Invite the bot with the URL the installer prints.
2. In Discord, run /watch and paste a BookMyShow link.
3. Wait. The DM arrives when tickets go live.

git clone https://github.com/Ishannaik/seatsniper.git && cd seatsniper
cp .env.example .env                  # fill in DISCORD_TOKEN and DISCORD_CLIENT_ID
docker compose run --rm seatsniper bun run commands   # register slash commands
docker compose up -d

The database lives in a named volume, so the bot survives container restarts.

bun install               # installs via bun.sh
cp .env.example .env      # DISCORD_TOKEN, DISCORD_CLIENT_ID
bun run commands          # register slash commands
bun run start             # or: bun run dev for watch mode

pm2 start "$HOME/.bun/bin/bun" --name seatsniper --interpreter none --time -- run src/index.ts
pm2 save

Each user can hold up to 5 watches.

1. Save. /watch parses the link, then hits BookMyShow once to confirm the movie exists. Bad links fail here, not days later.
2. Poll. Every POLL_INTERVAL_SEC (default 600 s) the bot checks each watch. Watches on the same movie share one request.
3. Detect. Availability comes from the showDateCode on each show. BookMyShow silently serves the nearest bookable date when the one you asked for is closed, so the URL, the HTTP status, and the page header all lie. The per-show field does not.
4. Notify. A dated watch DMs you once, then removes itself. A subscription compares today's dates and cinemas against what it has seen before and DMs the difference.

Failure is never silence. A blocked or unparseable response throws and logs; after 3 consecutive failures the bot tells you, so a dead poller cannot sit quietly forever.

src/
  index.ts      bot, poll loop, slash handlers
  bms.ts        BookMyShow client, URL parsing, availability
  db.ts         SQLite: watches, seen dates, seen venues
  messages.ts   Discord copy and embeds
  register.ts   slash command registration
assets/          logo
docs/            design specs and measured findings

• Geo-fenced. Datacenter IPs outside India can be blocked. A home server in India is the safest host. The bot speaks Safari's TLS fingerprint via node-tls-client, which passes BookMyShow's Cloudflare checks.
• No heuristics. Availability is a field comparison, not a scrape-and-guess. The measured findings behind this live in docs/superpowers/specs/2026-07-27-bms-access-findings.md.

Bug reports, feature ideas, and PRs are welcome. Start with CONTRIBUTING.md, which covers the setup and the hard constraints the bot was built around. Report security issues privately, see SECURITY.md.

MIT, see LICENSE.

⭐ If SeatSniper saved you a ticket, star the repo so the next person finds it.

_{Observes and notifies only. Never buys tickets. Made for the Friday 9 AM rush.}