thuisaccu-calculator/README.md

Thuisbatterij arbitrage rekentool

Een rekentool waarmee je kunt uitrekenen of het loont om een thuisbatterij in te zetten voor arbitrage op de dynamische stroomprijs. De tool haalt actuele en historische EPEX prijzen op via energyzero.nl en vergelijkt vijf strategieën op basis van jouw parameters (capaciteit, vermogen, rendement, aanschafprijs, energiebelasting, terugleververgoeding, etc.).

De app draait volledig in de browser. Er is geen server, geen tracking, geen account. Je instellingen worden lokaal opgeslagen in localStorage.

Vereisten

• Een moderne browser (Chrome, Edge, Firefox, Safari — laatste twee versies)
• Internetverbinding (voor de Tailwind/Chart.js CDN en voor het ophalen van EPEX prijzen)

Er is geen build stap, geen Node.js, geen package manager nodig. Het hele project is één index.html.

Gebruik op macOS

1. Open Terminal.
2. Clone de repository:

   git clone https://git.martien.io/Martien/thuisaccu-calculator.git
   cd thuisaccu-calculator
   

3. Open index.html direct in je browser:

   open index.html
   

Optioneel: serveren via een lokale webserver

Als je liever via http://localhost draait (bijvoorbeeld om CORS-gedrag realistisch te testen), kun je een ingebouwde webserver gebruiken:

# Python 3 (voorgeïnstalleerd op macOS)
python3 -m http.server 8000

Open daarna http://localhost:8000 in je browser.

Gebruik op Windows

1. Open PowerShell of Command Prompt.

2. Clone de repository:

   git clone https://git.martien.io/Martien/thuisaccu-calculator.git
   cd thuisaccu-calculator
   

3. Open index.html direct in je browser:

   start index.html
   

   Of dubbelklik op het bestand in Verkenner.

Optioneel: serveren via een lokale webserver

# Python 3 (installeer via https://www.python.org als nodig)
python -m http.server 8000

Open daarna http://localhost:8000 in je browser.

Functionaliteit

• Parameters: capaciteit (kWh), laad/ontlaad vermogen (kW), round-trip rendement (%), aanschafprijs (EUR), levensduur in cycli, energiebelasting, BTW, terugleververgoeding.
• Strategievergelijker: vijf strategieën worden naast elkaar getoond met saldo per kWh (winst/verlies na alle kosten en verliezen).
• EPEX dag-strategie: haalt de prijscurve van vandaag op en berekent het potentiële arbitrage rendement.
• 30-dagen historische analyse: haalt de afgelopen 30 dagen EPEX prijzen op om te zien hoe vaak arbitrage in die periode zou hebben geloond.
• Light/Dark mode: volgt standaard je systeemvoorkeur, kan via de knop in de header worden gewijzigd.

Data en privacy

• Alle parameters en instellingen worden opgeslagen in localStorage onder de sleutel thuisbatterij_*.
• Wis je browser-storage om de app te resetten naar standaardwaarden.
• EPEX prijzen worden direct vanuit je browser opgehaald bij api.energyzero.nl — er gaat niets via een tussenliggende server.

Licentie

Geen licentie gespecificeerd — neem contact op met de auteur voor hergebruik buiten persoonlijk gebruik.