Mitmachen
evcc wird von der Community entwickelt. Für die meisten Beiträge brauchst du keinen Code.
Klein anfangen
Abschnitt betitelt „Klein anfangen“Fang nicht mit deinem großen Lieblingsfeature an, auch wenn KI-Agenten das unglaublich einfach und verlockend machen. Lies erst eine Weile in den Discussions und Issues mit und entwickle ein Gefühl dafür, wie die Community tickt. Deine Idee kam wahrscheinlich schon mal auf, also such danach und steig in die bestehende Diskussion ein. Fang mit etwas Kleinem an und bau darauf auf. Über größere Änderungen sollte in einem Issue oder einer Diskussion Einigkeit bestehen, bevor es an die Umsetzung und den Pull Request geht.
Anderen helfen
Abschnitt betitelt „Anderen helfen“Viele Fragen in den Discussions kann jemand beantworten, der das gleiche Gerät besitzt oder das gleiche Problem hatte. Auch beim Sichten neuer Meldungen kannst du helfen: gemeldete Fehler nachstellen, fehlende Logs anfragen und auf Duplikate hinweisen. Problem melden erklärt, was ein hilfreiches Issue enthält.
Neue Versionen testen
Abschnitt betitelt „Neue Versionen testen“Die Nightly-Version enthält alles, was seit dem letzten Release gemergt wurde. Alle Installationsanleitungen (z. B. Linux, Docker oder Home Assistant) erklären, wie du darauf umsteigst. Mach vor dem Wechsel ein Backup deiner Installation. Neue Funktionen starten oft als experimentell und müssen unter Konfiguration → Experimentell aktiviert werden.
Für einen Pull Request können Maintainer einen Test-Build mit Binaries und einem Docker-Image evcc/evcc:pr-<nummer> bereitstellen.
Ein kurzer Testbericht von jemandem mit passender Hardware bringt eine Änderung oft erst ins Ziel.
Wenn ein Pull Request noch keinen Test-Build hat und du ihn testen könntest, frag dort gerne danach.
Wie du neue Versionen der iOS- und Android-App vorab testest, steht im Beta-Abschnitt der App.
Deine eigenen Geräte
Abschnitt betitelt „Deine eigenen Geräte“Die besten ersten Beiträge kommen aus deinem eigenen Setup. Du besitzt Geräte wie einen Wechselrichter, eine Hausbatterie, ein Fahrzeug oder eine Wallbox, die die Maintainer nicht testen können. Bestätige Fehlerbehebungen oder verbessere die Hinweise eines Templates. Dein Gerät wird noch nicht unterstützt? Binde es zuerst als benutzerdefiniertes Gerät ein und mach daraus, sobald es läuft, ein Template für alle.
Übersetzen
Abschnitt betitelt „Übersetzen“Die Oberfläche wird auf Weblate übersetzt. Füge eine neue Sprache hinzu oder prüfe und verbessere eine bestehende, ganz ohne Entwicklerwerkzeuge.
Doku verbessern
Abschnitt betitelt „Doku verbessern“Jede Seite hat unten einen Link Seite bearbeiten, der zur Quelle auf GitHub führt. Die Dokumentation gibt es auf Deutsch und Englisch. Wenn du nur eine der Sprachen sprichst, schreib das in deinen Pull Request und wir helfen bei der anderen.
Code schreiben
Abschnitt betitelt „Code schreiben“Die Contribution Guidelines beschreiben die Grundregeln, die Entwicklungsumgebung und wie du lokal testest. Allgemeine Entwicklungsthemen besprechen wir auf Slack.
Eigene Projekte rund um evcc
Abschnitt betitelt „Eigene Projekte rund um evcc“Dashboards, Displays, Tools oder Hardware-Gadgets, die anderen Nutzern helfen, sind ebenfalls ein Beitrag. Über die REST-API und MQTT-API kommst du an alle Daten deiner evcc-Instanz. Stell dein Projekt in den Discussions vor und trag es unter More Awesome Projects ein.
Projektübersicht
Abschnitt betitelt „Projektübersicht“| Repository | Inhalt | Technik |
|---|---|---|
| evcc-io/evcc | Kern, Weboberfläche und Geräte-Templates | Go, Vue |
| evcc-io/app | iOS- und Android-App | React Native |
| evcc-io/optimizer | Optimizer-Dienst | Python |
| evcc-io/docs | Diese Dokumentation | Astro, Markdown |
| evcc-io/images | Linux-Images für Raspberry Pi und andere Boards | Armbian |
| evcc-io/hassio-addon | Home-Assistant-App | Docker |
| evcc-io/evcc.io | Website | Hugo |
Problem melden zeigt, in welches Repository ein Problem gehört.
Contributor-Token
Abschnitt betitelt „Contributor-Token“Das Projekt lebt von vielen Menschen, die mit Code, Templates, Doku, Übersetzungen, Antworten in den Discussions oder ausführlichen Testberichten beitragen.
Du hast schon einiges beigetragen? Schreib uns eine kurze E-Mail mit deinem GitHub-Namen und wir stellen dir ein unbefristetes Sponsortoken aus.