Skip to content

About

Energy automation service for controlling household loads with electricity spot prices, consumption limits, own production and weather data. Made with Spring, Vaadin and React.

Topics

Resources

Stars

1 star

Watchers

0 watching

Forks

Latest commit

 

History

800 Commits

Folders and files

NameName
Last commit message
Last commit date
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 

Repository files navigation

Pörssiohjain ™

Home energy automation, from electricity prices to device control.

Pörssiohjain schedules compatible household devices around Nord Pool spot prices, power consumption, your own energy production and weather forecasts. Follow your home's energy use from a mobile dashboard or manage it through a retro desktop in your browser.

Open the web app · Get the Android app · Open mobile web · Visit the website

Hybrid-web dashboard showing device status, household consumption, solar production and automation shortcuts

The hybrid-web dashboard, available in the Android app and mobile browser.

What you can do

  • Schedule around electricity prices. Choose cheap hours, a continuous block or a schedule that considers tomorrow's prices. Include tax and energy/transfer contracts in the control price.
  • Respond to consumption. Monitor current power and interval history, set power limits and shed connected loads when needed.
  • Use your own production. Trigger device and heat-pump rules from SOFAR / SolarmanPV production data.
  • Plan for the weather. Use FMI forecasts for temperature and humidity rules. Heating Planner adds floor-heating plans and optional wood-stove guidance in the desktop interface.
  • Connect your devices. Integrate Shelly and other HTTP/MQTT devices, supported Toshiba and Mitsubishi heat pumps, and Zigbee/Tuya measurement sources.
  • See what is happening. View device connectivity, consumption, production, measurements and water-meter history. Share selected measurement charts through public links.
  • And much more. Explore Heating Planner, the solar angle planner, the Powerplant control-room board, resource sharing and other tools in the desktop interface.

A retro desktop in your browser

A desktop, Start menu and taskbar bring devices, charts and settings together. Open several feature windows, move between them and keep your current form state.

Pörssiohjain's retro desktop with feature shortcuts, device status and a taskbar

The desktop. Your devices and tools in one workspace.

A Vaadin control window displaying today's and tomorrow's electricity-price charts

Price controls. Inspect prices and the control table.

Android app

Energy Controller on Google Play is the Android app for Pörssiohjain. It runs the hybrid-web UI inside the app, with mobile access to device status, power use, own production and automation settings. The same UI is available at mobile.porssiohjain.fi.

The hosted service is available at app.porssiohjain.fi and app.energiaohjain.fi. These, the mobile-web address above and www.porssiohjain.fi are the official Pörssiohjain service domains.

GNOME desktop indicators

Keep electricity prices and Finland's wind-power production forecast in your desktop's top bar, with interactive graphs in the dropdown menus. Both indicators can run together, and neither requires an account or API token.

GNOME electricity-price indicator showing the current spot price and a graph for today and tomorrow

Electricity prices
Current spot price and today's/tomorrow's price chart.

GNOME Finnish wind-power forecast indicator showing production estimates in MW, daily averages and a forecast graph

Wind-power forecast
Finnish production forecasts in MW and daily averages.

Tested on GNOME Shell 46 / Ubuntu 24.04. Installation instructions · Download ready-to-install packages

Documentation

Looking for… Start here
Relay control or power-meter reporting Shelly setup
Application configuration Environment variables
How standard device control output works Control output flow
Device claiming, MQTT profiles and OTA Provisioning guide
Feature guides and integration details Documentation index

Development

The backend uses Java 21, Spring Boot, Vaadin and PostgreSQL. The mobile UI uses React and TypeScript; the GNOME indicators use GJS and Rust.

Build and run the backend tests with the repository's Gradle wrapper:

./gradlew compileJava test

See hybrid-web development and GNOME development for the other clients. Current backend configuration is defined in application.properties.

Support the project

If Pörssiohjain is useful to you, you can buy the developer a coffee.

License

This project is licensed under the Pörssiohjain Personal Use License v1.0.

Private individuals may self-host it for their own household use. Commercial use, resale, managed hosting, customer installations, or offering it as a service to third parties requires a separate written commercial license.

See the LICENSE file for details.

About

Energy automation service for controlling household loads with electricity spot prices, consumption limits, own production and weather data. Made with Spring, Vaadin and React.

Topics

Resources

Stars

1 star

Watchers

0 watching

Forks

Releases

Packages

Used by

Contributors

Languages