{"id":33926480,"url":"https://github.com/sukramj/homematicip_local","last_synced_at":"2026-05-23T08:05:17.755Z","repository":{"id":38109692,"uuid":"389120303","full_name":"SukramJ/homematicip_local","owner":"SukramJ","description":"A custom Home Assistant component for HomeMatic(IP) that connects to OpenCCU","archived":false,"fork":false,"pushed_at":"2026-04-22T17:02:54.000Z","size":5087,"stargazers_count":563,"open_issues_count":0,"forks_count":47,"subscribers_count":21,"default_branch":"devel","last_synced_at":"2026-04-26T06:41:47.372Z","etag":null,"topics":["ccu","custom-integration","eq-3","home-assistant","homegear","homematic","homematicip","openccu"],"latest_commit_sha":null,"homepage":"https://sukramj.github.io/aiohomematic/user/homeassistant_integration/","language":"Python","has_issues":true,"has_wiki":null,"has_pages":null,"mirror_url":null,"source_name":null,"license":"mit","status":null,"scm":"git","pull_requests_enabled":true,"icon_url":"https://github.com/SukramJ.png","metadata":{"files":{"readme":"README.md","changelog":"changelog.md","contributing":".github/CONTRIBUTING.md","funding":".github/FUNDING.yml","license":"LICENSE","code_of_conduct":null,"threat_model":null,"audit":null,"citation":null,"codeowners":null,"security":null,"support":null,"governance":null,"roadmap":null,"authors":null,"dei":null,"publiccode":null,"codemeta":null,"zenodo":null,"notice":null,"maintainers":null,"copyright":null,"agents":null,"dco":null,"cla":null},"funding":{"github":"SukramJ","patreon":null,"open_collective":null,"ko_fi":null,"tidelift":null,"community_bridge":null,"liberapay":null,"issuehunt":null,"lfx_crowdfunding":null,"polar":null,"buy_me_a_coffee":null,"thanks_dev":null,"custom":null}},"created_at":"2021-07-24T14:37:18.000Z","updated_at":"2026-04-26T03:02:42.000Z","dependencies_parsed_at":"2025-12-31T08:09:23.348Z","dependency_job_id":null,"html_url":"https://github.com/SukramJ/homematicip_local","commit_stats":null,"previous_names":["sukramj/custom_homematic","danielperna84/custom_homematic"],"tags_count":758,"template":false,"template_full_name":null,"purl":"pkg:github/SukramJ/homematicip_local","repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/SukramJ%2Fhomematicip_local","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/SukramJ%2Fhomematicip_local/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/SukramJ%2Fhomematicip_local/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/SukramJ%2Fhomematicip_local/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/SukramJ","download_url":"https://codeload.github.com/SukramJ/homematicip_local/tar.gz/refs/heads/devel","sbom_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/SukramJ%2Fhomematicip_local/sbom","scorecard":null,"host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":286080680,"owners_count":32686249,"icon_url":"https://github.com/github.png","version":null,"created_at":"2022-05-30T11:31:42.601Z","updated_at":"2026-05-06T08:33:17.875Z","status":"ssl_error","status_checked_at":"2026-05-06T08:33:17.221Z","response_time":117,"last_error":"SSL_connect returned=1 errno=0 peeraddr=140.82.121.6:443 state=error: unexpected eof while reading","robots_txt_status":"success","robots_txt_updated_at":"2025-07-24T06:49:26.215Z","robots_txt_url":"https://github.com/robots.txt","online":false,"can_crawl_api":true,"host_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub","repositories_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories","repository_names_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repository_names","owners_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners"}},"keywords":["ccu","custom-integration","eq-3","home-assistant","homegear","homematic","homematicip","openccu"],"created_at":"2025-12-12T10:17:42.127Z","updated_at":"2026-05-06T09:03:10.249Z","avatar_url":"https://github.com/SukramJ.png","language":"Python","funding_links":["https://github.com/sponsors/SukramJ"],"categories":[],"sub_categories":[],"readme":"# Homematic(IP) Local for OpenCCU\n\n[![releasebadge]][release]\n[![License][license-shield]](LICENSE)\n[![hainstall][hainstallbadge]][hainstall]\n[![GitHub Sponsors][sponsorsbadge]][sponsors]\n[![hacs][hacsbadge]][hacs]\n\nHomematic(IP) Local for OpenCCU is a custom [integration](https://www.home-assistant.io/getting-started/concepts-terminology/#integrations) for Home Assistant.\n\n## At a Glance\n\n- Local Home Assistant integration for Homematic(IP) hubs (CCU2/3, OpenCCU, Debmatic, Homegear). No cloud required.\n- Communication: Local XML-RPC for control and push state updates; JSON-RPC for names and rooms.\n- Installation: HACS recommended; manual installation supported.\n- Auto-discovery: Supported for CCU and compatible hubs.\n- Minimum requirements: Home Assistant 2025.10.0+; for Homematic IP on CCU require at least CCU2 2.61.x / CCU3 3.61.x.\n\n## Quick Start\n\n| Resource | Link |\n|----------|------|\n| **Full Documentation** | [User Guide](https://sukramj.github.io/aiohomematic/user/homeassistant_integration/) |\n| **Installation** | See [Installation](#installation) below |\n| **Alternative Setup (OpenCCU)** | [OpenCCU Wiki](https://github.com/OpenCCU/OpenCCU/wiki/HomeAssistant-Integration) |\n| **Changelog** | [changelog.md](changelog.md) |\n| **Issues** | [GitHub Issues](https://github.com/sukramj/aiohomematic/issues) |\n| **Discussions** | [GitHub Discussions](https://github.com/sukramj/aiohomematic/discussions) |\n\n## Related Integrations\n\n| Integration | Use Case |\n|-------------|----------|\n| **This integration** | Local connection to CCU2/3, OpenCCU, Debmatic, Homegear |\n| [Homematic(IP) Cloud](https://www.home-assistant.io/integrations/homematicip_cloud) | Cloud connection via Homematic IP Access Point |\n| [Homematic IP Local (HCU)](https://github.com/Ediminator/hacs-homematicip-hcu) | Local connection to HmIP-HCU1 |\n\n## Installation\n\n### HACS (Recommended)\n\n1. In Home Assistant, go to **HACS** \u003e **Integrations** \u003e **Explore \u0026 Download Repositories**\n2. Search for \"Homematic(IP) Local for OpenCCU\" and install it\n3. Restart Home Assistant when prompted\n\n### Manual Installation\n\n1. Copy the `custom_components/homematicip_local` directory to your Home Assistant `config/custom_components` directory\n2. Restart Home Assistant\n\n\u003e **Note:** Manual installation does not support automatic updates.\n\nAfter installation, add the integration via **Settings** \u003e **Devices \u0026 Services** \u003e **Add Integration** or use this button:\n\n[![Add Integration][hainstallbadge]][hainstall]\n\n## Requirements\n\n### Supported Hardware\n\n- CCU2/3\n- OpenCCU\n- Debmatic\n- Homegear\n- Home Assistant OS/Supervised with suitable add-on + communication device\n\n### Required Ports\n\n| Interface | Purpose | Port | TLS Port |\n|-----------|---------|------|----------|\n| HomematicIP (HmIP-RF) | Wireless/wired HmIP devices | 2010 | 42010 |\n| Homematic (BidCos-RF) | Classic wireless devices | 2001 | 42001 |\n| Homematic Wired | Classic wired devices | 2000 | 42000 |\n| Virtual Devices | Heating groups | 9292 | 49292 |\n| JSON-RPC | Names and rooms | 80 | 443 |\n\n### Authentication\n\n- Admin privileges required on your CCU\n- Allowed password characters: `A-Z`, `a-z`, `0-9`, `.!$():;#-`\n- XML-RPC authentication recommended (Settings \u003e Control Panel \u003e Security)\n\nFor complete requirements and configuration details, see the [Full Documentation](https://sukramj.github.io/aiohomematic/user/homeassistant_integration/).\n\n## Documentation\n\nThe complete documentation is available at **[sukramj.github.io/aiohomematic](https://sukramj.github.io/aiohomematic/)**:\n\n| Topic | Link |\n|-------|------|\n| **Home Assistant Integration** | [User Guide](https://sukramj.github.io/aiohomematic/user/homeassistant_integration/) |\n| **Actions Reference** | [Actions](https://sukramj.github.io/aiohomematic/user/features/homeassistant_actions/) |\n| **Troubleshooting** | [Troubleshooting Guide](https://sukramj.github.io/aiohomematic/user/troubleshooting/homeassistant_troubleshooting/) |\n| **Week Profiles** | [Week Profiles](https://sukramj.github.io/aiohomematic/user/features/week_profile/) |\n| **Naming Conventions** | [Naming](https://sukramj.github.io/aiohomematic/user/advanced/homeassistant_naming/) |\n| **Glossary** | [Glossary](https://sukramj.github.io/aiohomematic/reference/glossary/) |\n\n### Additional Resources\n\n- **Contributing Guide**: See [CONTRIBUTING.md](CONTRIBUTING.md) for development setup and contribution guidelines\n- **Local Naming Documentation**: See [docs/naming.md](docs/naming.md)\n\n## Device Configuration Panel\n\nA built-in sidebar panel for editing Homematic device **MASTER parameters** directly from the Home Assistant UI.\n\n### Features\n\n- Browse all configurable devices grouped by interface\n- View device details including reachability, RSSI, and firmware\n- Edit MASTER paramset values per channel with auto-generated forms (sliders, toggles, dropdowns)\n- Validate changes before writing to the device\n- Reset parameters to factory defaults\n\n### Enabling the Panel\n\n1. Go to **Settings → Devices \u0026 Services → Homematic(IP) Local**\n2. Click **Configure** on your integration entry\n3. Navigate to **Advanced Options**\n4. Enable **Device configuration panel**\n5. The panel appears in the sidebar as **Homematic Config**\n\n\u003e **Note:** The panel requires admin access and is not visible to non-admin users.\n\n## Blueprints\n\nReady-to-use automation blueprints are available in the [blueprints/automation](blueprints/automation) directory:\n\n- Support for 2/4/6/8-button remotes\n- Persistent notifications for unavailable devices\n- Device reactivation helpers\n- Error event handlers\n\nCopy the desired blueprint files to your `config/blueprints/automation` directory.\n\nCommunity blueprints are welcome via pull request in [blueprints/community](blueprints/community).\n\n## Companion Cards\n\nEnhance your Home Assistant dashboard with custom cards designed for this integration:\n\n| Card | Description |\n|------|-------------|\n| [Climate Schedule Card](https://github.com/SukramJ/homematicip_local_climate_schedule_card) | Visual editor for Homematic thermostat week profiles. Edit heating schedules directly from your dashboard. |\n\n## Support and Contributing\n\n| Resource | Link |\n|----------|------|\n| **Report Issues** | [GitHub Issues](https://github.com/sukramj/aiohomematic/issues) |\n| **Discussions** | [GitHub Discussions](https://github.com/sukramj/aiohomematic/discussions) |\n| **Documentation** | [sukramj.github.io/aiohomematic](https://sukramj.github.io/aiohomematic/) |\n| **Contributing** | [CONTRIBUTING.md](CONTRIBUTING.md) |\n| **Sponsor** | [GitHub Sponsors](https://github.com/sponsors/SukramJ) |\n\n## License\n\nThis project is licensed under the MIT License. See [LICENSE](LICENSE) for details.\n\n[license-shield]: https://img.shields.io/github/license/SukramJ/homematicip_local.svg?style=for-the-badge\n[release]: https://github.com/SukramJ/homematicip_local/releases\n[releasebadge]: https://img.shields.io/github/v/release/SukramJ/homematicip_local?style=for-the-badge\n[hainstall]: https://my.home-assistant.io/redirect/config_flow_start/?domain=homematicip_local\n[hainstallbadge]: https://img.shields.io/badge/dynamic/json?style=for-the-badge\u0026logo=home-assistant\u0026logoColor=ccc\u0026label=usage\u0026suffix=%20installs\u0026cacheSeconds=15600\u0026url=https://analytics.home-assistant.io/custom_integrations.json\u0026query=$.homematicip_local.total\n[sponsorsbadge]: https://img.shields.io/github/sponsors/SukramJ?style=for-the-badge\u0026label=GitHub%20Sponsors\u0026color=green\n[sponsors]: https://github.com/sponsors/SukramJ\n[hacs]: https://hacs.xyz\n[hacsbadge]: https://img.shields.io/badge/HACS-Default-green.svg?style=for-the-badge\n","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fsukramj%2Fhomematicip_local","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Fsukramj%2Fhomematicip_local","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fsukramj%2Fhomematicip_local/lists"}