Ista Energy Monitor for Home Assistant

A custom Home Assistant integration to monitor your heating consumption from the Ista portal (mijn.ista.nl).

Features

• Monitor total heating consumption across all rooms
• Individual sensors for each room in your apartment
• Automatic updates every hour
• Easy configuration through Home Assistant UI
• Support for both English and Dutch

Prerequisites

• Home Assistant installation
• Active Ista account at mijn.ista.nl
• Valid login credentials (email and password)

Installation

Method 1: HACS (Recommended)

1. Ensure HACS is installed in your Home Assistant
2. Open HACS in your Home Assistant
3. Click on "Integrations"
4. Click the three dots (⋮) in the top right corner
5. Select "Custom repositories"
6. Add repository URL: https://github.com/sircuri/ista-plugin
7. Select category: "Integration"
8. Click "Add"
9. Click "Download" on the "Ista Energy Monitor" integration
10. Restart Home Assistant
11. Go to Settings → Devices & Services → Add Integration
12. Search for "Ista Energy Monitor" and add it

Method 2: Manual Installation

1. Download the latest release from GitHub releases
2. Extract the downloaded zip file
3. Copy the custom_components/ista folder to your Home Assistant's custom_components directory
   • The path should be: config/custom_components/ista/
4. Restart Home Assistant

Configuration

1. In Home Assistant, go to Settings → Devices & Services
2. Click + Add Integration
3. Search for "Ista Energy Monitor"
4. Enter your Ista portal credentials:
   • Email or Username: Your Ista account email/username
   • Password: Your Ista account password
5. Click Submit

The integration will authenticate with the Ista portal and create sensors for:

• Total heating consumption (all rooms combined)
• Individual consumption for each room in your apartment

Sensors

After configuration, the following sensors will be available:

Total Consumption Sensor

• Entity ID: sensor.ista_total_consumption
• Name: Ista Total Consumption
• Unit: units
• Icon: 🌡️ (heat-wave)
• Attributes:
  • unit: Measurement unit
  • room_count: Number of rooms monitored

Room Sensors

• Entity ID: sensor.ista_[room_name]
• Name: Ista [Room Name]
• Unit: units
• Icon: 🔥 (radiator)
• Attributes:
  • meter_number: Meter identification number
  • unit: Measurement unit

Usage Examples

Lovelace Card

type: entities
title: Heating Consumption
entities:
  - entity: sensor.ista_total_consumption
  - entity: sensor.ista_living_room
  - entity: sensor.ista_bedroom
  - entity: sensor.ista_kitchen

Automation Example

automation:
  - alias: "High Heating Usage Alert"
    trigger:
      - platform: numeric_state
        entity_id: sensor.ista_total_consumption
        above: 1000
    action:
      - service: notify.mobile_app
        data:
          message: "High heating consumption detected: {{ states('sensor.ista_total_consumption') }} units"

Update Interval

The integration updates data from the Ista portal every hour (3600 seconds). This can be adjusted in the const.py file by modifying the UPDATE_INTERVAL value.

Troubleshooting

Authentication Fails

• Verify your credentials by logging into mijn.ista.nl manually
• Ensure your account is active and has access to consumption data
• Check Home Assistant logs for detailed error messages

No Data Displayed

• Wait for the first update cycle (up to 1 hour)
• Check if data is available on the Ista portal at mijn.ista.nl/Home/Data
• The integration may need adjustment if Ista changes their website structure

Sensors Not Appearing

• Restart Home Assistant after installation
• Check the Home Assistant logs for error messages
• Ensure the integration is properly configured in Settings → Devices & Services

Data Privacy

This integration:

• Stores your credentials locally in Home Assistant
• Communicates directly with the Ista portal (no third-party services)
• Does not share your data with anyone
• Uses the same authentication flow as the Ista website

Technical Details

How It Works

1. Authentication: Uses OpenID Connect (Keycloak) to authenticate with the Ista portal
2. Data Retrieval: Scrapes the consumption data page after successful authentication
3. Parsing: Extracts room names, meter numbers, and consumption values from the HTML
4. Updates: Polls the Ista portal every hour to get the latest data
5. Sensors: Creates Home Assistant sensor entities with the consumption data

API Limitations

The Ista portal does not provide an official API. This integration uses web scraping to retrieve data, which means:

• Changes to the Ista website may break the integration
• The integration relies on the HTML structure of the data page
• Updates may be needed when Ista updates their portal

Contributing

If you encounter issues or want to contribute:

1. Check if the Ista portal structure has changed
2. Update the parsing logic in api.py if needed
3. Submit a pull request or open an issue

Disclaimer

This is an unofficial integration and is not affiliated with, endorsed by, or connected to Ista. Use at your own risk.

License

This project is licensed under the MIT License.

Support

For issues, questions, or feature requests, please open an issue on GitHub.