room_cal_ha/README.md

Room Calendar HA

A Home Assistant custom integration for managing room/rental reservations via CalDAV or the room_cal REST API.

Installation via HACS

1. In HACS, go to Integrations → Custom repositories
2. Add https://git.zi3.xyz/code/room_cal_ha with category Integration
3. Install Room Calendar from HACS
4. Restart Home Assistant
5. Add the integration via Settings → Devices & Services → Add Integration → Room Calendar

Requirements

• Home Assistant 2026.5 or later
• For CalDAV mode: a CalDAV server with caldav + icalendar Python packages (installed automatically)
• For API mode: a running room_cal REST API instance