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 bekomm 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. Ein kleiner erster Beitrag ist der beste Einstieg, alles Weitere ergibt sich mit der Zeit. Größere Änderungen brauchen Einigkeit in einem Issue oder einer Diskussion, 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 Sortieren 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 sie installierst. 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.
Hat ein Pull Request noch keinen Test-Build und du könntest ihn testen, 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 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 | Was es ist | 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 der Mitarbeit vieler Menschen, mit Code, Templates, Doku, Übersetzungen, Antworten in den Discussions oder ausführlichen Testberichten.
Du hast schon einiges beigetragen? Schreib uns eine kurze Mail mit deinem GitHub-Namen und wir stellen dir ein unbefristetes Unterstützertoken aus.