Get Discord notifications when new Volo Sports pickups and drop-ins are posted in San Diego.
Checks Volo Sports every 5 minutes for new pickups/drop-ins across all sports except softball. When something new pops up, you get a Discord ping with the details.
Drop-ins only notify when the Volo API reports male-eligible spots. If a drop-in is first seen with no male-eligible spots, it stays pending and can notify later if spots open up.
- Clone this repo.
- Install dependencies:
pip install -r requirements.txt
- Copy
.env.exampleto.envand add your Discord webhook URL. - Run it:
python watcher.py
By default, first run sends notifications for current notifiable activities. Set NOTIFY_ON_STARTUP=false if you only want pings after the first poll.
Create a webhook in Discord: Server Settings -> Integrations -> Webhooks -> New Webhook.
Copy the URL and put it in your .env file.
The recommended free-tier deployment is Cloudflare Workers Cron + D1. This repo
includes a Worker port in src/worker.js, D1 migrations in migrations/, and
Wrangler config in wrangler.toml.
Cloudflare quick start:
- Install Worker dependencies:
npm install
- Log in and create the D1 database:
npx wrangler login npx wrangler d1 create solovolo
- Copy the generated D1
database_idintowrangler.toml. - Apply the remote migration:
npx wrangler d1 migrations apply solovolo --remote
- Store your Discord webhook as a Worker secret:
npx wrangler secret put DISCORD_WEBHOOK_URL
- Deploy:
npm run deploy
For local Cloudflare testing, create .dev.vars with DISCORD_WEBHOOK_URL=...,
run npm run dev, then call:
curl "http://localhost:8787/__scheduled?cron=*+*+*+*+*"The original Python worker still works on any server that can run Python. Set
DISCORD_WEBHOOK_URL as an environment variable.
Optional environment variables:
POLL_INTERVAL: seconds between checks, default300.EXCLUDED_SPORTS: comma-separated sports to suppress, defaultSoftball.WATCHED_SPORTS: comma-separated sports to check. Leave unset to check all sports.NOTIFY_ON_STARTUP: set tofalseto skip startup notifications.SEND_STARTUP_STATUS: set tofalseto skip the "online" ping on worker boot.DB_PATH: override the SQLite path, useful if Railway has a mounted volume.
Cloudflare ignores POLL_INTERVAL, SEND_STARTUP_STATUS, and DB_PATH.
Schedule frequency comes from wrangler.toml, state is stored in D1, and there
is no long-running process startup ping.
For Railway, connect the repo and add the env vars. railway.json sets the start command to python watcher.py.
Volo pickups fill up fast. This lets you know immediately instead of checking manually.