Skip to content

FaserF/ha-boulderwelt

Repository files navigation

Boulderwelt Home Assistant Integration 🧗‍♂️

GitHub Release GitHub Workflow Status hacs_badge GitHub Sponsors

Monitor the real-time occupancy of your favorite Boulderwelt hall directly in Home Assistant. Plan your next session when it's less crowded!


Features ✨

  • Live Occupancy: Real-time percentage of hall utilization.
  • High Occupancy Alert: Binary sensor indicating if the hall is currently "full" (>= 75%).
  • Multi-Location Support: Configure multiple halls if you frequent different spots.
  • Configurable Updates: Set your own scan interval (default: 5 minutes).
  • Native UI Configuration: Fully supports Config Flow and Options Flow.
  • Device Support: All entities are properly grouped under a single device per hall.

Supported Locations 📍

  • München Ost
  • München Süd
  • München West
  • Hamburg
  • Dortmund
  • Frankfurt
  • Karlsruhe
  • Regensburg

Installation 🛠️

1. Using HACS (Recommended)

  1. Open HACS in your Home Assistant instance.
  2. Click on Integrations.
  3. Search for "Boulderwelt".
  4. Click Download and restart Home Assistant.

2. Manual Installation

  1. Download the boulderwelt.zip from the latest release.
  2. Extract the archive and copy the custom_components/boulderwelt directory into your Home Assistant's custom_components folder.
  3. Restart Home Assistant.

Configuration ⚙️

  1. Navigate to Settings -> Devices & Services.
  2. Click Add Integration in the bottom right.
  3. Search for "Boulderwelt".
  4. Select your hall and set the desired update interval.

Tip

You can change the update interval any time by clicking Configure on the integration card.


Sensors & Entities 📊

Entity Type Description
sensor.<hall>_occupancy Sensor Current occupancy in %
binary_sensor.<hall>_highly_occupied Binary Sensor on if occupancy >= 75% (disabled by default)

Example Dashboard Card

type: entities
entities:
  - entity: sensor.boulderwelt_muenchen_ost_occupancy
    name: München Ost Auslastung
  - entity: binary_sensor.boulderwelt_muenchen_ost_highly_occupied
    name: Viel los?
title: Boulderwelt 🧗

Statistics & Daily Averages 📈

To track daily averages, you can use the built-in Home Assistant statistics platform. Add this to your configuration.yaml:

sensor:
  - platform: statistics
    name: "Boulderwelt Daily Mean"
    entity_id: sensor.boulderwelt_muenchen_ost_occupancy
    state_characteristic: mean
    max_age:
      hours: 24

Contributing 🤝

Contributions are welcome! If you find a bug or have a feature request, please open an issue.

Credits


Disclaimer: This integration is not affiliated with, endorsed by, or supported by Boulderwelt. It uses public API endpoints provided by their website.

About

Fetch Boulderwelt full utilization for Homeassistant

Topics

Resources

License

Contributing

Stars

Watchers

Forks

Contributors

Languages