AutoWOD

Automatically books your workout sessions on WODBuster — the booking platform used by many CrossFit gyms. Once set up, it runs every day in the cloud so you never have to worry about grabbing a spot.

Is your gym on WODBuster? Check your gym's booking page URL. If it contains wodbuster.com, you're good to go.

---

What you need before starting

• A GitHub account (free) — sign up here if you don't have one
• Your WODBuster login email and password

---

Setup (one time only)

1. Fork this repository

Click the Fork button at the top right of this page. This creates your own private copy of the tool under your GitHub account.

2. Add your secrets

Secrets are for sensitive information like your password. GitHub keeps them encrypted and never shows them in logs.

1. In your forked repository, click Settings
2. In the left sidebar, click Secrets and variables → Actions
3. Make sure you're on the Secrets tab
4. Click New repository secret and add each of the following:

Name	Value
EMAIL	Your WODBuster login email
PASSWORD	Your WODBuster password

3. Set your weekly schedule

Your schedule uses repository variables — unlike secrets, you can see and edit them at any time without deleting and recreating them. These are NOT environment variables on your computer; they live on GitHub, in your repository settings.

1. Still in Settings → Secrets and variables → Actions
2. Click the Variables tab (not the Secrets tab)
3. Click New repository variable and add a variable for each day you want to book

Name	Value example	Meaning
MONDAY	18:00	Book the 6 PM class every Monday
TUESDAY	18:00	Book the 6 PM class every Tuesday
WEDNESDAY	09:00	Book the 9 AM class every Wednesday
THURSDAY	18:00
FRIDAY	18:00
SATURDAY	10:00
SUNDAY	10:00

• Use 24-hour format (18:00 not 6:00 PM)
• Only add variables for days you actually want to book — skip the rest

Two classes at the same time? If your gym offers multiple classes at the same start time (e.g. CrossFit and Endurance both at 18:00), add the class name after a |:

MONDAY=18:00|CrossFit
TUESDAY=18:00|Endurance

Optional — how many days ahead to book:

Name	Value	Meaning
AVAILABLE_DAYS	7	Book up to 7 days in advance (default if not set)
BOOKING_FREQUENCY	daily	Use daily to try every day, or weekly to book only once per week
BOOKING_WEEKDAY	sunday	Used with BOOKING_FREQUENCY=weekly; choose monday through sunday

4. Enable GitHub Actions

1. Click the Actions tab in your forked repository
2. If prompted, click I understand my workflows, go ahead and enable them

That's it! By default, the tool will now run automatically every evening around 22:30 Spain time.

---

Checking if it worked

1. Click the Actions tab in your repository
2. Click the latest AutoWOD run
3. You'll see a summary card showing exactly what happened for each day — no need to read through logs

A green checkmark means the run completed. Check the summary card to see which sessions were booked.

---

Changing your schedule

Go to Settings → Secrets and variables → Actions → Variables tab, click the repository variable you want to change (e.g. MONDAY), update the value, and save. The next run will pick it up automatically.

---

Updating to the latest version

AutoWOD improves over time. Because you're running your own fork, updates don't reach you automatically — you pull them in with one click.

1. Go to your forked repository's main page
2. If your fork is behind, GitHub shows a This branch is X commits behind notice near the top
3. Click Sync fork, then Update branch

Your secrets and schedule variables are stored separately in your repository settings, so syncing never touches them. The next scheduled run uses the updated code.

---

My gym opens all reservations on one day

Some gyms release the full week's schedule at once (e.g. every Sunday). In that case, set these repository variables:

Name	Value example
BOOKING_FREQUENCY	weekly
BOOKING_WEEKDAY	sunday
AVAILABLE_DAYS	7

The workflow still wakes up every day because GitHub Actions schedules cannot be changed by repository variables, but AutoWOD will skip immediately on the other days before installing dependencies or launching the browser.

You can also trigger the tool manually whenever you need:

1. Go to Actions → Daily Reservation
2. Click Run workflow (top right)
3. In the Days to book ahead field, enter the number of days you want to cover (e.g. 7)
4. Click Run workflow

Manual runs always run immediately, even when BOOKING_FREQUENCY=weekly.

---

Troubleshooting

The run shows a red ✗

• Open the run and check the summary card or the step logs for the error message
• Most common cause: a secret is missing or has a typo — double-check EMAIL and PASSWORD

All days show "Skipped" in the summary

• You haven't added any repository variables yet — go to Settings → Secrets and variables → Actions → Variables tab and add at least one (e.g. name: MONDAY, value: 18:00)

"Could not find Chrome" error

• Make sure your fork is up to date with the latest version of this repository
• Do not remove or modify the Install Chrome for Puppeteer step in the workflow file

Wrong class booked when multiple classes share a time

• Add the class name to your variable: MONDAY=18:00|CrossFit
• The name match is not case-sensitive

WODBuster starts showing a CAPTCHA again

• WODBuster does not currently show a CAPTCHA on login, so AutoWOD needs no CAPTCHA service or API key
• AutoWOD keeps its 2Captcha fallback in case the check returns. If that happens, create a 2Captcha account, add credit, and save its API key as the TWO_CAPTCHA_API_KEY repository secret

---

Privacy & cost

• Your email and password are stored as encrypted GitHub secrets — only your workflow can read them
• GitHub Actions is free for public repositories
• AutoWOD currently requires no paid service

---

Disclaimer

This tool is designed for WODBuster-powered gyms. Please make sure you have permission from your gym to automate bookings, and use it responsibly in line with their booking policies.

License

ISC — see the LICENSE file for details.