{"id":15170314,"url":"https://github.com/ibepower/ibepower-homeassistant-integration","last_synced_at":"2026-01-24T00:12:19.045Z","repository":{"id":257369169,"uuid":"858059476","full_name":"Ibepower/Ibepower-Homeassistant-Integration","owner":"Ibepower","description":"Ibepower Home Assistant Integration","archived":false,"fork":false,"pushed_at":"2024-10-06T13:44:53.000Z","size":333,"stargazers_count":0,"open_issues_count":0,"forks_count":0,"subscribers_count":1,"default_branch":"main","last_synced_at":"2024-11-06T11:50:06.644Z","etag":null,"topics":["custom-component","energy-monitoring","hacs","hacs-integration","home-assistant","integration","smart-plug"],"latest_commit_sha":null,"homepage":"https://www.ibepower.com","language":"Python","has_issues":true,"has_wiki":null,"has_pages":null,"mirror_url":null,"source_name":null,"license":"gpl-3.0","status":null,"scm":"git","pull_requests_enabled":true,"icon_url":"https://github.com/Ibepower.png","metadata":{"files":{"readme":"README.md","changelog":null,"contributing":null,"funding":null,"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}},"created_at":"2024-09-16T08:27:58.000Z","updated_at":"2024-10-06T13:42:50.000Z","dependencies_parsed_at":"2024-11-06T11:53:29.454Z","dependency_job_id":null,"html_url":"https://github.com/Ibepower/Ibepower-Homeassistant-Integration","commit_stats":{"total_commits":24,"total_committers":1,"mean_commits":24.0,"dds":0.0,"last_synced_commit":"d2d84970717996ed2a23546d59e061f3eeb403b5"},"previous_names":["ibepower/ibepower-homeassistant-integration-hacs"],"tags_count":4,"template":false,"template_full_name":null,"repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/Ibepower%2FIbepower-Homeassistant-Integration","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/Ibepower%2FIbepower-Homeassistant-Integration/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/Ibepower%2FIbepower-Homeassistant-Integration/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/Ibepower%2FIbepower-Homeassistant-Integration/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/Ibepower","download_url":"https://codeload.github.com/Ibepower/Ibepower-Homeassistant-Integration/tar.gz/refs/heads/main","host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":231234375,"owners_count":18345243,"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":["custom-component","energy-monitoring","hacs","hacs-integration","home-assistant","integration","smart-plug"],"created_at":"2024-09-27T08:01:23.554Z","updated_at":"2026-01-24T00:12:19.019Z","avatar_url":"https://github.com/Ibepower.png","language":"Python","funding_links":[],"categories":[],"sub_categories":[],"readme":"\n# Ibepower Home Assistant Integration\n\n\u003cp align=\"center\"\u003e\n  \u003cimg src=\"https://raw.githubusercontent.com/Ibepower/Ibepower-Homeassistant-Integration/main/images/Ibepower.png\"\u003e\n\u003c/p\u003e\n\n### A custom integration to control and monitor **Ibepower** smart devices in [Home Assistant](https://www.home-assistant.io/). This integration supports multiple device types, including **Ibeplug**, and allows you to control relays, monitor power consumption, and get real-time energy data.\n\n---\n\n## Features\n\n- **Control Relays**: Turn on/off smart plugs and other relays.\n- **Monitor Power Consumption**: Get detailed power usage data including total energy, power factor, voltage, and current.\n- **Real-Time Updates**: Receive real-time updates based on device response, ensuring fast and accurate state changes.\n- **Multiple Device Support**: Supports various devices from Ibepower, starting with the **Ibeplug** smart plug.\n\n---\n\n## Installation\n\n### HACS Installation\n\n1. **Add Custom Repository:**\n\n   - Open HACS in Home Assistant.\n   - Go to **Integrations**.\n   - Click on the three dots in the top right corner and select **Custom repositories**.\n   - Add the repository URL: `https://github.com/Ibepower/Ibepower-Homeassistant-Integration` and select the category **Integration**.\n\n2. **Install the Integration:**\n\n   - Search for **Ibepower Home Assistant Integration** in HACS.\n   - Click on **Install** and wait for the installation to complete.\n\n3. **Restart Home Assistant:**\n\n - After the installation, restart Home Assistant to load the new integration.\n\n### Manual Installation\n\n1. **Download the integration:**\n\n   Clone the repository or download the ZIP file:\n\n   ```bash\n   git clone https://github.com/Ibepower/Ibepower-Homeassistant-Integration.git\n   ```\n\n2. **Copy files to Home Assistant:**\n\n   - Place the contents of the `ibepower` folder inside the `custom_components` directory of your Home Assistant configuration folder.\n\n     Your directory structure should look like this:\n\n     ```bash\n     └── custom_components\n         └── ibepower\n             ├── __init__.py\n             ├── config_flow.py\n             ├── const.py\n             ├── ibediv_device.py\n             ├── ibeplug_device.py\n             ├── manifest.json\n             ├── number.py\n             ├── select.py\n             ├── sensor.py\n             └── switch.py\n     ```\n\n3. **Restart Home Assistant:**\n\n   - After copying the files, restart Home Assistant for the integration to be loaded.\n\n---\n\n## Configuration\n\n### 1. **Discover Devices Automatically**\n\n   After restarting Home Assistant, the integration will automatically discover compatible Ibepower devices using mDNS. You can find and configure these devices via the Home Assistant interface under **Settings \u003e Devices \u0026 Services**.\n\n### 2. **Manual Configuration**\n\n   If you need to configure a device manually, you can go to **Settings \u003e Devices \u0026 Services \u003e Add Integration**, and search for **Ibepower**. You will be prompted to enter the device details. (In developement)\n\n---\n\n## Example of Supported Devices\n\n### **1. Ibeplug Smart Plug**\n   The integration supports **Ibeplug**, a smart plug with relay control and power monitoring features.\n\n   - **Relay Control**: Turn on/off the plug.\n   - **Energy Monitoring**: Monitor voltage, current, power, total energy, and power factor.\n\n---\n\n## Energy Data Collected\n\n| Sensor         | Description                       | Unit   |\n|----------------|-----------------------------------|--------|\n| Voltage        | The voltage of the device         | V      |\n| Current        | Current flowing through the plug  | A      |\n| Power          | Active power being consumed       | W      |\n| Total Energy   | Total energy consumed             | kWh    |\n| Power Factor   | Efficiency of energy usage        | %      |\n| Energy Today   | Total energy used today           | kWh    |\n| Energy Yesterday| Total energy used yesterday      | kWh    |\n\n---\n\n## Future Features\n\n- Support for additional Ibepower devices (e.g., Ibediv, Ibemeter).\n- Enhanced energy tracking and reporting.\n\n---\n\n## Troubleshooting\n\n- **Devices not being discovered**: Ensure your devices are connected to the same network as Home Assistant and that mDNS is enabled on your router.\n- **State changes delayed**: The integration attempts to retrieve real-time state from the devices after sending a command. If delays persist, try lowering the `update_interval` in the integration code.\n- **Device errors**: Check the Home Assistant logs for errors related to device communication.\n\n---\n\n## Contributing\n\nContributions are welcome! If you have ideas or want to improve this integration, feel free to create a pull request or open an issue in the GitHub repository.\n\n1. Fork the repository.\n2. Create a new branch: `git checkout -b my-new-feature`.\n3. Commit your changes: `git commit -m 'Add some feature'`.\n4. Push to the branch: `git push origin my-new-feature`.\n5. Submit a pull request.\n\n---\n\n## License\n\nThis project is licensed under the GNU General Public License v3.0 - see the [LICENSE](LICENSE) file for details.\n\n---\n\n## Support\n\nFor any issues or questions, feel free to open an issue in the GitHub repository or contact [soporte@ibepower.com](mailto:soporte@ibepower.com).\n\n---\n\n## Screenshots\n\n\u003cp align=\"center\"\u003e\n  \u003cimg src=\"https://raw.githubusercontent.com/Ibepower/Ibepower-Homeassistant-Integration/main/images/HACS%20Card.png\"\u003e\n\u003c/p\u003e\n\u003cp align=\"center\"\u003e\n  \u003cimg src=\"https://raw.githubusercontent.com/Ibepower/Ibepower-Homeassistant-Integration/main/images/HACS%20Integration%20List.png\"\u003e\n\u003c/p\u003e\n\u003cp align=\"center\"\u003e\n  \u003cimg src=\"https://raw.githubusercontent.com/Ibepower/Ibepower-Homeassistant-Integration/main/images/HACS%20Integration%20Devices.png\"\u003e\n\u003c/p\u003e\n\u003cp align=\"center\"\u003e\n  \u003cimg src=\"https://raw.githubusercontent.com/Ibepower/Ibepower-Homeassistant-Integration/main/images/HACS%20Ibeplug%20Info.png\"\u003e\n\u003c/p\u003e\n\n---\n\nMade with ❤️ by [Ibepower](https://github.com/Ibepower).\n","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fibepower%2Fibepower-homeassistant-integration","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Fibepower%2Fibepower-homeassistant-integration","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fibepower%2Fibepower-homeassistant-integration/lists"}