{"id":15860751,"url":"https://github.com/stuartp44/haduco","last_synced_at":"2026-02-01T19:04:21.583Z","repository":{"id":250592865,"uuid":"834881254","full_name":"stuartp44/haduco","owner":"stuartp44","description":null,"archived":false,"fork":false,"pushed_at":"2024-07-28T17:52:32.000Z","size":5,"stargazers_count":0,"open_issues_count":0,"forks_count":0,"subscribers_count":1,"default_branch":"main","last_synced_at":"2025-02-07T13:17:31.348Z","etag":null,"topics":[],"latest_commit_sha":null,"homepage":null,"language":"Python","has_issues":true,"has_wiki":null,"has_pages":null,"mirror_url":null,"source_name":null,"license":null,"status":null,"scm":"git","pull_requests_enabled":true,"icon_url":"https://github.com/stuartp44.png","metadata":{"files":{"readme":"README.md","changelog":null,"contributing":null,"funding":null,"license":null,"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}},"created_at":"2024-07-28T16:38:17.000Z","updated_at":"2024-07-28T17:52:35.000Z","dependencies_parsed_at":"2024-07-28T18:05:47.898Z","dependency_job_id":null,"html_url":"https://github.com/stuartp44/haduco","commit_stats":null,"previous_names":["stuartp44/haduco"],"tags_count":0,"template":false,"template_full_name":null,"repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/stuartp44%2Fhaduco","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/stuartp44%2Fhaduco/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/stuartp44%2Fhaduco/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/stuartp44%2Fhaduco/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/stuartp44","download_url":"https://codeload.github.com/stuartp44/haduco/tar.gz/refs/heads/main","host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":246709923,"owners_count":20821297,"icon_url":"https://github.com/github.png","version":null,"created_at":"2022-05-30T11:31:42.601Z","updated_at":"2022-07-04T15:15:14.044Z","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":[],"created_at":"2024-10-05T22:00:53.186Z","updated_at":"2026-01-04T17:14:10.383Z","avatar_url":"https://github.com/stuartp44.png","language":"Python","funding_links":[],"categories":[],"sub_categories":[],"readme":"# DUCO Ventilation \u0026 Sun Control\n\n[![CI/CD Pipeline](https://github.com/stuartp44/haduco/actions/workflows/release.yml/badge.svg)](https://github.com/stuartp44/haduco/actions/workflows/release.yml)\n[![HACS](https://img.shields.io/badge/HACS-Custom-orange.svg)](https://github.com/hacs/integration)\n[![GitHub Release](https://img.shields.io/github/release/stuartp44/haduco.svg)](https://github.com/stuartp44/haduco/releases)\n[![License](https://img.shields.io/github/license/stuartp44/haduco.svg)](LICENSE)\n\nHome Assistant Custom Component for DUCO Ventilation \u0026 Sun Control systems.\n\nThis integration allows you to monitor and control your DUCO ventilation and sun protection devices directly from Home Assistant through local network communication.\n\n## Features\n\n- **Local Control**: Direct communication with DUCO devices on your local network\n- **Auto-Discovery**: Automatic discovery via Zeroconf\n- **Sensor Platform**: Monitor ventilation status, air quality, and system parameters\n- **Select Platform**: Control ventilation modes and sun protection settings\n- **Configuration Flow**: Easy setup through the Home Assistant UI\n- **Real-time Updates**: Automatic polling for device state changes\n\n## Installation\n\n### HACS (Recommended)\n\n1. Open HACS in Home Assistant\n2. Go to \"Integrations\"\n3. Click the three dots in the top right corner\n4. Select \"Custom repositories\"\n5. Add this repository URL: `https://github.com/stuartp44/haduco`\n6. Select category: \"Integration\"\n7. Click \"Add\"\n8. Find \"DUCO Ventilation \u0026 Sun Control\" in the integration list\n9. Click \"Download\"\n10. Restart Home Assistant\n\n### Manual Installation\n\n1. Download the latest release from [Releases](https://github.com/stuartp44/haduco/releases)\n2. Extract the files\n3. Copy the `custom_components/duco_ventilation_sun_control` directory to your Home Assistant `custom_components` directory\n4. Restart Home Assistant\n\n## Configuration\n\n### Via UI (Recommended)\n\n1. Go to **Settings** → **Devices \u0026 Services**\n2. Click **+ Add Integration**\n3. Search for \"DUCO Ventilation \u0026 Sun Control\"\n4. Follow the configuration steps\n5. Enter your DUCO device IP address and port (default: 80)\n\n### Auto-Discovery\n\nIf your DUCO device supports Zeroconf, it will be automatically discovered. Simply click **Configure** when the integration appears in your notifications.\n\n## Entities\n\nAfter configuration, the integration will create entities for:\n\n### Sensors\n- System status\n- Air quality metrics\n- Temperature readings\n- Fan speeds\n- Operating modes\n\n### Selects\n- Ventilation modes (Auto, Manual, Sleep, etc.)\n- Fan speed control\n- Sun protection positions\n\n## Development\n\nSee [CONTRIBUTING.md](CONTRIBUTING.md) for development guidelines and [docs/DEVELOPMENT.md](docs/DEVELOPMENT.md) for setup instructions.\n\n### Quick Start\n\n```bash\n# Clone the repository\ngit clone https://github.com/stuartp44/haduco.git\ncd haduco\n\n# Install dependencies\npip install -r requirements_test.txt\n\n# Run tests\npytest tests/\n\n# Run linting\nruff check .\nruff format .\nmypy custom_components/duco_ventilation_sun_control\n```\n\n## Documentation\n\n- [Release Pipeline](docs/RELEASE_PIPELINE.md) - Automated release process\n- [Development Guide](docs/DEVELOPMENT.md) - Development setup and workflow\n- [Commit Guide](docs/COMMIT_GUIDE.md) - Commit message conventions\n- [Contributing](CONTRIBUTING.md) - How to contribute\n- [Security Policy](SECURITY.md) - Security and vulnerability reporting\n\n## Requirements\n\n- Home Assistant 2024.1.0 or newer\n- Python 3.11 or newer\n- Network access to DUCO device\n- ducopy==17\n- retrying==1.3.4\n\n## Troubleshooting\n\n### Integration Not Discovered\n\n1. Ensure your DUCO device is on the same network\n2. Check if the device supports Zeroconf/mDNS\n3. Try manual configuration with the device IP address\n\n### Connection Issues\n\n1. Verify the IP address and port\n2. Check firewall settings\n3. Ensure the DUCO device is powered on and accessible\n4. Check Home Assistant logs for error messages\n\n### Enable Debug Logging\n\nAdd to your `configuration.yaml`:\n\n```yaml\nlogger:\n  default: info\n  logs:\n    custom_components.duco_ventilation_sun_control: debug\n```\n\n## Credits\n\nThis project was originally created by [@Sikerdebaard](https://github.com/Sikerdebaard). We are grateful for the foundation and vision he provided for this integration.\n\nSee [CONTRIBUTORS.md](CONTRIBUTORS.md) for a full list of contributors.\n\n## License\n\nThis project is licensed under the MIT License - see the [LICENSE](LICENSE) file for details.\n\n## Support\n\n- [Issues](https://github.com/stuartp44/haduco/issues) - Report bugs or request features\n- [Discussions](https://github.com/stuartp44/haduco/discussions) - Ask questions or share ideas\n\n## Disclaimer\n\nThis is a custom integration and is not officially supported by DUCO. Use at your own risk.\n\n---\n\n**Made for the Home Assistant community**\n","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fstuartp44%2Fhaduco","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Fstuartp44%2Fhaduco","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fstuartp44%2Fhaduco/lists"}