ajvpot/camply

camply, the campsite finder ⛺️, is a tool to help you book a campsite online. Finding reservations at sold out campgrounds can be tough. That's where camply comes in. It searches thousands of campgrounds across the ~~USA~~ world via the APIs of booking services like https://recreation.gov. It continuously checks for cancellations and availabilities to pop up - once a campsite becomes available, camply sends you a notification to book your spot!

Check Out The Docs

Installing

Install camply via pip or pipx:

pipx install camply

Usage

Search for a specific recreation area (recreation areas contain campgrounds):

camply recreation-areas --search "Glacier National Park"

Search for campgrounds (campgrounds contain campsites):

camply campgrounds --search "Fire Lookout Towers" --state CA

Search for available campsites, get a notification whenever one becomes available, and continue searching after the first one is found. The below command is using silent notifications as an example but camply also supports Email, Slack, Twilio (SMS), Pushover, Pushbullet, Ntfy, Apprise, and Telegram.

camply campsites \
    --rec-area 2725 \
    --start-date 2023-07-10 \
    --end-date 2023-07-18 \
    --notifications silent \
    --search-forever

Providers

camply works with a number of providers. A "provider" is an online booking service that lists camping and recreation inventory.

RecreationDotGov: Searches on Recreation.gov for Campsites (default provider)
Yellowstone: Searches on YellowstoneNationalParkLodges.com for Campsites
GoingToCamp: Searches on GoingToCamp.com for Campsites
ReserveCalifornia: Searches on ReserveCalifornia.com for Campsites (California State Parks)
AlabamaStateParks: Searches on ReserveAlaPark.com for Campsites
ArizonaStateParks: Searches on AZStateParks.com for Campsites
FloridaStateParks: Searches on FloridaStateParks.org for Campsites
MinnesotaStateParks: Searches on ReserveMN.usedirect.com for Campsites
MissouriStateParks: Searches on icampmo1.usedirect.com for Campsites
OhioStateParks: Searches on ReserveOhio.com for Campsites
VirginiaStateParks: Searches on ReserveVAParks.com for Campsites
NorthernTerritory: Searches the Australian Northern Territory for Campsites
FairfaxCountyParks: Searches on fairfax.usedirect.com for Campsites (Virginia)
MaricopaCountyParks: Searches on MaricopaCountyParks.org for Campsites (Arizona)
OregonMetro: Searches on OregonMetro.gov for Campsites (Portland Metro)
RecreationDotGovTicket: Searches on Recreation.gov for Tickets and Tours
RecreationDotGovTimedEntry: Searches on Recreation.gov for Timed Entries

Run camply providers to list current providers and visit the Providers section in the docs to learn more.

Documentation

Head over to the camply documentation to see what you can do!

❯ camply --help

 Usage: camply [OPTIONS] COMMAND [ARGS]...

 Welcome to camply, the campsite finder.
 Finding reservations at sold out campgrounds can be tough. That's where camply comes in. It searches the
 APIs of booking services like https://recreation.gov (which indexes thousands of campgrounds across the
 USA) to continuously check for cancellations and availabilities to pop up. Once a campsite becomes
 available, camply sends you a notification to book your spot!


 visit the camply documentation at https://juftin.com/camply

╭─ Options ──────────────────────────────────────────────────────────────────────────────────────────────╮
│                                                                                                        │
│  --debug/--no-debug             Enable extra debugging output                                          │
│  --provider              TEXT   Camping Search Provider. Defaults to 'RecreationDotGov'                │
│  --version                      Show the version and exit.                                             │
│  --help                         Show this message and exit.                                            │
│                                                                                                        │
╰────────────────────────────────────────────────────────────────────────────────────────────────────────╯
╭─ Commands ─────────────────────────────────────────────────────────────────────────────────────────────╮
│                                                                                                        │
│  campgrounds              Search for Campgrounds (inside of Recreation Areas) and list them            │
│  campsites                Find Available Campsites with Custom Search Criteria                         │
│  configure                Set up camply configuration file with an interactive console                 │
│  equipment-types          Get a list of supported equipment                                            │
│  list-campsites           List campsite IDs for a given campground or recreation area                  │
│  providers                List the different camply providers                                          │
│  recreation-areas         Search for Recreation Areas and list them                                    │
│  test-notifications       Test your notification provider setup                                        │
│  tui                      Open Textual TUI.                                                            │
│                                                                                                        │
╰────────────────────────────────────────────────────────────────────────────────────────────────────────╯

Contributing

Camply doesn't support your favorite campsite booking provider yet? Consider contributing 😉.

Recreation data provided by Recreation.gov

ajvpot / camply