Forecast of your solar power plant's output, as an installable web app.
solXpect web is a web version of the Android app solXpect by woheller69. It looks and works like the app, and it calculates with the improved model of the Python library solXpect_meets_python. The app runs in the browser and can be added to the home screen. It needs no app store and no developer registration, and it works offline with the last forecast.
Open the app: https://blablubbbb.github.io/solxpect_web/
- Same screens as the app:
- Today: energy produced so far and still to come.
- The hours ahead, with Σ since midnight.
- The week, with a bar chart of the days.
- One tab per plant.
- "Show sum" for plants at the same coordinates (
myPV | part1,myPV | part2are shown asmyPV).
- Manage locations:
- Place search with a map; tap the map to place a plant exactly.
- Hold and drag to sort, swipe to delete (with undo), clone.
- All of the app's plant settings, including the shading table with 36 directions.
- New in the web version:
- Shared inverters. Plants connected to the same inverter (for example two strings on one hybrid inverter) share it: its efficiency and power limit apply to their sum, and each plant shows its share.
- Cooling factor per plant (the app always uses 0.0342 °C per W/m²).
- Calculation choice:
- 15 min (default): 15-minute weather data, with sun position and shading every 7.5 minutes, multiplied before averaging.
- 1 h with the same method.
- 1 h "like the Android app".
- The shading table marks directions the sun never reaches in front of the panel, and shows the highest sun elevation in each direction.
- Backups:
- Own backup file (JSON).
- Restore reads both this app's backups and the Android app's
solXpect.zip. - "Export for the Android app" writes a
solXpect.zipthe app can restore. Before exporting, it lists what the app can't represent.
- Works offline, can be installed. When a new version is available, the app shows "Reload".
- Languages: English, German, Spanish, Italian, Turkish and Simplified Chinese. They are picked from the browser's languages and can be changed in Settings.
- Android (Chrome): open https://blablubbbb.github.io/solxpect_web/ once while online, then ⋮ → Add to home screen (or Install app).
- iPhone (Safari): Share → Add to Home Screen.
Plants and settings are stored only in the browser (localStorage) on your device. The app makes only these network requests:
- the coordinates of your plants to Open-Meteo, to get the weather forecast;
- your search text to the Open-Meteo geocoding API, while you search for a place;
- map tiles from OpenStreetMap, while you add a location.
There is no server of its own, no tracking and no account. Clearing the browser data deletes the plants, so make a backup now and then (Backup/Restore → Backup database). The app asks for this at the first start.
Plain HTML, CSS and JavaScript, no build step. Serve the folder with any static web server, for example python -m http.server, and open http://localhost:8000.
| File | Content |
|---|---|
index.html, style.css, app.js |
the app: pages, cards, dialogs, storage |
model.js |
calculation engine, a port of the Python library (sun position, sub-steps, shading, cell temperature, inverter) |
backup.js |
own JSON backup; reading and writing the Android app's solXpect.zip (ZIP + SQLite via sql.js) |
i18n.js, help.js |
texts and instructions in six languages |
sw.js |
service worker for offline use. Raise CACHE whenever you change a file, otherwise installed apps keep the old version |
manifest.webmanifest, icons/ |
installation, app icon, weather icons from solXpect |
vendor/ |
Leaflet 1.9.4 (map), sql.js 1.10.3 (SQLite in WebAssembly, loaded only for Android backups) |
-
python tests/run_tests.pyrunstests/test.htmlin headless Edge or Chrome. It checks:model.jsagainst values computed with the Python library, fromtests/reference.json: sun position; the app's original calculation (576 values); whole sites with shared inverters, hourly and 15 min, in both calculation modes; the reachable sun directions;- the backup round trips.
-
python tests/make_reference.pyregeneratestests/reference.json. It needs the library clone next to this repository. -
python tests/ui_check.pyclicks through the app with Playwright (pip install playwright; it uses the installed Edge) and saves screenshots totests/local/. Its checks:- the plant shares add up to the location sum;
- drag-to-sort, and swipe-to-delete with undo, work;
- there are no console errors.
tests/local/is not in the repository, because it may hold private backups.
- solXpect web: GNU General Public License v3.0, see LICENSE. It is derived from:
- solXpect by woheller69 (GPL-3.0): screens, texts and their translations, weather icons, the original model;
- solXpect_meets_python (GPL-3.0): the calculation.
- Leaflet 1.9.4: BSD-2-Clause, see vendor/leaflet/LICENSE.txt
- sql.js 1.10.3: MIT, see vendor/sqljs/LICENSE.txt
- Material Design Icons (Google): Apache License 2.0
- Weather data: Open-Meteo.com, CC BY 4.0. Map data: © OpenStreetMap contributors.