Simple CLI for interacting with the recreation.gov API.
Includes polling and notifications, so you can get notified if a fully booked campground has a cancelation for the dates you're interested in. Run locally or deploy to Render.
Option 1: Install with Brew
brew tap opencamp-hq/homebrew-opencamp
brew install opencamp
Option 2: Precompiled Binaries
Precompiled binaries for the project can be found in the Releases section.
➜ opencamp search "kirk creek"
- Kirk Creek Campground Big Sur, California ID: 233116
- Bird Creek Campground Ely, Nevada ID: 234209
- Defeated Creek Park Carthage, Tennessee ID: 232572
- Grassy Creek Park Clarksville, Virginia ID: 10107534
➜ opencamp check 233116 09-11-2023 09-12-2023
The following sites are available for those dates:
- Site 004 Book at: https://www.recreation.gov/camping/campsites/70286
- Site 007 Book at: https://www.recreation.gov/camping/campsites/70079
- Site 008 Book at: https://www.recreation.gov/camping/campsites/70163
- Site 014 Book at: https://www.recreation.gov/camping/campsites/70857
- Site 018 Book at: https://www.recreation.gov/camping/campsites/70573
➜ opencamp poll 233116 09-11-2023 09-12-2023 --interval=10m
INFO[06-09|14:24:37] No sites available atm, starting polling! interval=10m0s
INFO[06-09|14:34:37] Sorry, no available campsites were found for your dates. We'll try again in 10m0s
INFO[06-09|14:44:37] Sorry, no available campsites were found for your dates. We'll try again in 10m0s
...
Both the check and poll commands support email notifications when a campsite is found available.
To get notified via email, you'll be prompted to supply your SMTP credentials interactively. Alternately, you can supply these credentials as environment variables (SMTP_HOST, SMTP_EMAIL, etc) or in a config.yaml to allow the tool to run in a headless mode (ie: as a cron). See Configuration for more info.
➜ opencamp poll 233116 09-11-2023 09-12-2023 --notify=email
In order to get notified by email, please specify your email SMTP details
SMTP Server: smtp.gmail.com
SMTP Port: 587
Email address: your-email@gmail.com
Password: *************
INFO[06-09|14:24:37] No sites available at the moment, starting polling! interval=10m0s
INFO[06-09|14:34:37] Sorry, no available campsites were found for your dates. We'll try again in 10m0s
...
INFO[06-11|18:14:37] Sorry, no available campsites were found for your dates. We'll try again in 10m0s
Just in! The following sites are now available for those dates:
- Site 004 Book at: https://www.recreation.gov/camping/campsites/70286
- Site 005 Book at: https://www.recreation.gov/camping/campsites/70079
INFO[06-11|18:14:43] Notification email sent
Note: SMTP credentials are stored in memory and not echoed to stdout, but you should still be conscious of the security implications of authenticating with an SMTP server like this.
If you want to use Gmail as your smtp server and you have two factor authentication enabled, you'll need to generate an app password here: https://myaccount.google.com/apppasswords.
Configuration values can be passed as command line flags, set as environment variables, or defined in a config.yaml file, with precedence defined in that order.
Example config.yaml:
interval: 10m
notify: email
smtp:
host: smtp.gmail.com
port: 587
email: your-email@gmail.com
password: your-password
verbose: true
For nested configuration, the equivalent env var is a concatenation of keys with an _, ie: host in the yaml file above becomes SMTP_HOST.
You can run the CLI as a daemon but if you don't have a machine that runs 24/7 Render provides one-click deployment functionality similar to Heroku. Based on the settings defined in the render.yaml file, the CLI will be deployed as a cron job that runs once every 10m.
Please be mindful of polling too frequently, once every 10 minutes is the recommended max. Running the tool at a higher frequency is unlikely to make a difference and risks recreation.gov authenticating their API and breaking this type of access for everyone.
- Sign up for Render. In order to deploy the CLI as a cron job, you'll need to enter a credit card, but the billing rate is $0.0094/hr
- Note: The minimum for a cron job is $1/mo, which is what you'll probably end up spending
- Click the Deploy to Render button below
- Enter values for the environment variables. Example values for each environment variable are in the render.yaml file
- Note: You'll need to determine the id of the campground you're interested in by running the tool locally first, ie: Search for a campground
- Check the logs to ensure the cronjob is successfully running
- If a campground is available, you'll get an e-mail with a link to book
Distributed under the MIT License. See LICENSE for more information.