So reichst du ein Template ein

Bevor du beginnst

Du benötigst zwei Dinge, bevor du einreichst.

1. Ein GitHub-Konto. Dein Template-Repo muss auf GitHub gehostet werden. Wenn du noch kein Konto hast, erstelle zuerst eines.
2. Ein abgeschlossenes Design. Stelle sicher, dass du mit deiner .picopixel-Datei zufrieden bist, bevor du einreichst. Exportiere sie aus der PicoPixel-App und halte sie zum Hinzufügen zu deinem Repo bereit.

Dein GitHub-Repo einrichten

Erstelle ein neues öffentliches GitHub-Repository für deine Template-Einreichung. Das Repo sollte drei Dinge enthalten:

1. Deine .picopixel-Datei

Lege deine .picopixel-Design-Datei im Root des Repos ab. Das ist die Datei, die die Leute herunterladen und in PicoPixel öffnen werden, also stelle sicher, dass es die finale Version ist.

2. Vorschaubilder

Füge alle Bilder hinzu, die du neben deinem Template in der Galerie anzeigen möchtest. Diese helfen den Leuten zu sehen, wie das Design aussieht, bevor sie es herunterladen.

• Lege Bilder im Root des Repos oder in einem Ordner wie images/ ab.
• Verwende gängige Formate: .png, .jpg oder .webp.
• Füge mindestens einen Screenshot deines Designs in Aktion bei. Mehrere Ansichten oder Bildschirme sind noch besser.
• Halte Bilder in einer vernünftigen Größe – groß genug, um Details zu sehen, aber nicht unnötig riesig.

3. Eine README

Schreibe eine README.md im Root des Repos. Diese wird als Beschreibung des Templates in der Galerie verwendet, behandle sie also als die öffentliche Seite für dein Template.

Eine gute README sollte abdecken:

• Was das Template ist – eine kurze Zusammenfassung des Designs und wofür es gedacht ist.
• Zielauflösung und Hardware – das Board oder Display, für das es gebaut wurde, damit die Leute wissen, ob es zu ihrem Setup passt.
• Was enthalten ist – liste die Bildschirme, Widgets und wichtigsten Funktionen auf. Zum Beispiel: „zwei Bildschirme: ein Haupt-Dashboard und eine Einstellungsseite, mit Schiebereglern, Umschaltern und einem Uhr-Widget."
• Danksagungen – wenn du Drittanbieter-Assets verwendet hast, die du lizenziert teilen kannst, nenne sie und ihre Quelle.

Hier ist ein minimales Beispiel:

# Weather Dashboard Template

A clean two-screen weather dashboard designed for 320×240 TFT displays.

## What's included

- **Home screen** — current temperature, humidity, and a 3-day forecast row
- **Settings screen** — unit toggle (°C/°F), update interval slider, and Wi-Fi status

## Built for

- 320×240 resolution
- ILI9341 or similar TFT displays

## Credits

Weather icons from [Meteocons](https://bas.dev/work/meteocons) (MIT license).

Das Formular ausfüllen

Sobald dein Repo bereit ist, gehe zum Einreichungsformular.

1. Öffne die PicoPixel-App und melde dich an.
2. Klicke auf dein Konto am unteren Rand der linken Seitenleiste, dann wähle Dein Konto.
3. In der Dein-Konto-Seitenleiste öffne Template einreichen.

Das Formular hat drei Felder:

• GitHub-Repo-Link – die URL deines öffentlichen GitHub-Repositories (z. B. https://github.com/deinname/mein-template). Das Repo muss öffentlich sein, damit das Review-Team darauf zugreifen kann. Überprüfe, ob das Repo deine .picopixel-Datei, Bilder und README enthält, bevor du einreichst.
• Autor / Danksagungen – der Name, der als Ersteller des Templates angezeigt werden soll. Füge alle hinzu, die neben dir genannt werden sollen.
• Hinweise (optional) – alles, was das Review-Team wissen sollte und nicht in deiner README steht. Zum Beispiel, wenn bestimmte Bilder nicht in der Galerie-Auflistung verwendet werden sollen, oder wenn es Kontext zum Design gibt, der nicht in die öffentliche Beschreibung gehört.

Wenn alles stimmt, sende das Formular ab.

Rechte und Genehmigungen

Das Einreichen eines Templates gewährt echte Rechte, also lies dies sorgfältig durch, bevor du absendest.

Durch das Einreichen räumst du PicoPixel die Genehmigung ein, den Inhalt deines Repositories öffentlich in der Community-Templates-Galerie zu öffnen, herunterzuladen und zu veröffentlichen. Veröffentlichte Templates werden ohne Urheberrechtsbeschränkungen oder Lizenzanforderungen zur Verfügung gestellt, sodass jeder sie frei in seinen eigenen Projekten verwenden kann, auch für kommerzielle Zwecke. Deine Quellenangabe wird angezeigt, aber das Template selbst ist für andere frei verwendbar.

Das bedeutet, dass du nur Arbeit einreichen solltest, mit der du dich wohl fühlst, sie zu diesen Bedingungen zu teilen. Wenn ein Teil deines Designs ein Asset verwendet, das du nicht erstellt hast – eine Schriftart, Icon-Set, Bild oder ähnliches – und du dir nicht sicher bist, ob du es frei und uneingeschränkt teilen kannst, entferne es vor dem Einreichen. Im Zweifel lieber weglassen: Ein sauberes Template ist für andere viel nützlicher als eines, das später entfernt werden muss.

PicoPixel kann Inhalte entfernen, die Rechte Dritter verletzen. Siehe die Nutzungsbedingungen.

Was als nächstes passiert

Nach deiner Einreichung klont das PicoPixel-Team dein Repo und überprüft das Template. Die Überprüfung stellt sicher, dass die .picopixel-Datei korrekt geöffnet wird, dass die Bilder und README angemessen sind und dass die Einreichung den Nutzungsbedingungen entspricht.

Das Team kann sich melden, wenn etwas geklärt oder behoben werden muss. Sobald es die Überprüfung besteht, wird das Template in der Templates-Galerie mit deiner Quellenangabe und deiner README als Beschreibung veröffentlicht. Von dort aus kann jeder es als Ausgangspunkt für sein eigenes Design verwenden.

Wenn ein veröffentlichtes Template jemals korrigiert oder entfernt werden muss (deins oder das eines anderen), siehe So meldest du Inhalte.

Wohin als nächstes

• Templates-Galerie – stöbere durch Community-Templates
• So reichst du einen Pet ein – teile stattdessen einen animierten Sprite
• So meldest du Inhalte – melde ein Problem mit einem Pet oder Template
• Nutzungsbedingungen – die Regeln, die für Einreichungen gelten