Hi all,
I’ve been working on a new Homey app for the EcoFlow STREAM Series, and it is now available in the Homey App Store:
The idea behind the app is to bring the EcoFlow STREAM balcony-solar and home-battery platform properly into Homey, rather than just exposing a few basic readings.
I use the STREAM system in my own home, and I wanted deeper integration with Homey Energy, Insights, Flows and dashboards so that Homey can understand where the energy is coming from, where it is going, and make useful decisions around it.
Supported devices
The app is focused specifically on the EcoFlow STREAM platform, including:
- STREAM Ultra
- STREAM Ultra X
- STREAM Pro
- STREAM Max
- STREAM AC Pro
- STREAM Solar
- STREAM Microinverter
- STREAM Socket
- EcoFlow Smart Meter
The app creates separate devices where appropriate for the household battery, individual STREAM units, solar production, microinverters, AC sockets and the Smart Meter.
This makes it possible to see both the overall household system and the individual components behind it.
What does it do?
The app brings live EcoFlow energy data into Homey, including:
- Battery level and charging state
- Battery health and cycle count
- Battery temperature and voltage
- Solar generation
- Individual PV inputs
- Battery charging and discharging power
- Household consumption
- Power supplied from solar, battery and grid
- Grid import and export
- AC output power
- Smart Meter readings
- Cumulative imported and exported energy
- Estimated time until the battery is full or empty
- Fault and availability information
The app uses EcoFlow’s realtime connection where available, with regular polling as a fallback, so energy readings should update quickly while remaining resilient if the realtime connection drops.
Homey Energy and Insights
A major focus has been making the integration work properly with Homey Energy.
The household STREAM battery is represented as home storage, the Smart Meter provides grid import and export, and STREAM Solar and Microinverter devices provide solar-production information.
Measurements are also recorded in Homey Insights, making it possible to review battery, solar, grid and household-energy behaviour over time.
Battery and system control
The app allows you to control key STREAM settings from Homey, including:
- Operating mode
- Backup reserve from 3% to 100%
- Charge limit
- Discharge limit
- Grid feed-in
- Individual STREAM Socket and AC outputs
This means the STREAM system can become part of wider Homey automations instead of needing to be managed separately in the EcoFlow app.
Flow support
There are Flow cards for responding to changes in the system, including:
- Solar power changing
- Grid import or export starting
- Grid power crossing a chosen threshold
- Battery charging or discharging
- Battery level crossing a chosen percentage
- Operating mode changing
- Devices going online or offline
- Faults being raised or cleared
There are also actions for changing operating modes, reserve levels, charge and discharge limits, feed-in settings and AC outputs.
I’ve included higher-level actions for common energy use cases such as:
- Preparing the battery for cheap grid import
- Preparing for a peak-price or export period
- Releasing the battery for export
These can be combined with tariff apps to build automations around cheap, expensive or negative electricity prices.
Dashboard widgets
The app includes five dashboard widgets:
- STREAM Energy Flow
- STREAM Today Balance
- STREAM Battery Plan
- STREAM Solar Target
- STREAM Tariff Opportunity
These provide a quicker overview of how energy is moving around the home, what the battery is doing, and whether there may be an opportunity to charge or export.
Setup
You’ll need EcoFlow IoT API credentials:
- Create an Access Key and Secret Key through the EcoFlow Developer Platform:
https://developer.ecoflow.com/ - Install the app from the Homey App Store.
- Add an EcoFlow STREAM or Smart Meter device.
- Enter the API credentials and select the appropriate region.
- Homey will discover the supported STREAM devices associated with the account.
Credentials can be managed later through the app settings.
Important notes
This is an independent community integration and is not affiliated with, authorised by or endorsed by EcoFlow.
It uses EcoFlow’s cloud and public IoT API, so an internet connection is required and behaviour may change if EcoFlow changes its API.
The app is deliberately focused on the STREAM home-energy platform. EcoFlow portable power stations and PowerStream are not currently included.
Feedback welcome
I’d really welcome feedback from other EcoFlow STREAM and Homey users.
I’m especially interested in:
- Which STREAM model and configuration you have
- Whether all units, sockets and meters are discovered correctly
- Whether the live battery, solar and grid values match the EcoFlow app
- Whether Homey Energy reports import, export, storage and solar correctly
- How the widgets work with different STREAM configurations
- Which Flow cards or controls would be most useful next
- Any device models or telemetry fields that are currently missing
I am actively developing the app based on real-world use and community feedback, so diagnostics and detailed examples are particularly helpful when something does not look right.
Thanks,
JZ
