Vue d'ensemble
Un modèle est l'un de vos fichiers PicoPixel, partagé pour que d'autres personnes puissent l'ouvrir comme point de départ. Plutôt que de construire un écran de zéro, elles démarrent avec votre mise en page, vos widgets et votre style déjà en place.
Les modèles sont soumis via GitHub. Vous créez un dépôt public contenant votre fichier .picopixel, les images que vous souhaitez mettre en avant, et un README qui décrit le modèle. Une fois accepté, votre modèle apparaît dans la galerie de Modèles de la communauté, où n'importe qui peut le parcourir et l'utiliser, avec votre crédit.
Ce guide explique comment configurer votre dépôt, remplir le formulaire de soumission, les droits que vous accordez, et comment donner à votre soumission les meilleures chances d'être acceptée.
Avant de commencer
Vous aurez besoin de deux choses avant de soumettre.
- Un compte GitHub. Votre dépôt de modèle doit être hébergé sur GitHub. Si vous n'avez pas de compte, créez-en un d'abord.
- Un design finalisé. Assurez-vous d'être satisfait de votre fichier
.picopixelavant de soumettre. Exportez-le depuis l'application PicoPixel et ayez-le prêt à ajouter à votre dépôt.
Vous devez être connecté à l'application PicoPixel pour accéder au formulaire de soumission. Ouvrez l'application PicoPixel et connectez-vous avec Google ou GitHub si ce n'est pas déjà fait.
Configurer votre dépôt GitHub
Créez un nouveau dépôt GitHub public pour votre soumission de modèle. Le dépôt doit contenir trois choses :
1. Votre fichier .picopixel
Placez votre fichier de design .picopixel à la racine du dépôt. C'est le fichier que les gens téléchargeront et ouvriront dans PicoPixel, alors assurez-vous que c'est la version finale.
2. Images de présentation
Ajoutez les images que vous souhaitez afficher à côté de votre modèle dans la galerie. Elles aident les gens à voir à quoi ressemble le design avant de le télécharger.
- Placez les images à la racine du dépôt ou dans un dossier comme
images/. - Utilisez des formats courants :
.png,.jpgou.webp. - Incluez au moins une capture d'écran de votre design en action. Plusieurs angles ou écrans, c'est encore mieux.
- Gardez les images à une taille raisonnable — assez grandes pour voir les détails, mais pas inutilement énormes.
3. Un README
Rédigez un README.md à la racine du dépôt. Il est utilisé comme description du modèle dans la galerie, alors traitez-le comme la page publique de votre modèle.
Un bon README doit couvrir :
- Ce qu'est le modèle — un bref résumé du design et à quoi il sert.
- Résolution cible et matériel — la carte ou l'écran pour lequel il a été conçu, pour que les gens sachent s'il convient à leur installation.
- Ce qui est inclus — listez les écrans, widgets et fonctionnalités clés. Par exemple : "deux écrans : un tableau de bord principal et une page de paramètres, avec des curseurs, des interrupteurs et un widget d'horloge."
- Crédits — si vous avez utilisé des ressources tierces que vous êtes autorisé à partager, nommez-les et leur source.
Imaginez quelqu'un qui arrive sur votre modèle dans la galerie sans aucun autre contexte. Si votre README répond à "qu'est-ce que c'est et est-ce que ça marchera pour moi ?", il fait son travail.
Voici un exemple minimal :
# 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). Remplir le formulaire
Une fois votre dépôt prêt, accédez au formulaire de soumission.
- Ouvrez l'application PicoPixel et connectez-vous.
- Cliquez sur votre compte en bas de la barre latérale gauche, puis choisissez Votre compte.
- Dans la barre latérale Votre compte, ouvrez Soumettre un modèle.
Le formulaire comporte trois champs :
- Lien du dépôt GitHub — l'URL de votre dépôt GitHub public (p. ex.
https://github.com/votrenom/mon-modele). Le dépôt doit être public pour que l'équipe de révision puisse y accéder. Vérifiez que le dépôt contient votre fichier.picopixel, les images et le README avant de soumettre. - Auteur / Crédits — le nom que vous voulez afficher comme créateur du modèle. Ajoutez toute personne qui doit être créditée à vos côtés.
- Notes (optionnel) — tout ce que l'équipe de révision devrait savoir et qui ne figure pas dans votre README. Par exemple, si certaines images ne doivent pas être utilisées dans la liste de la galerie, ou s'il y a un contexte sur le design qui n'appartient pas à la description publique.
Quand tout vous semble bon, soumettez le formulaire.
Droits et autorisations
Soumettre un modèle accorde de véritables autorisations, alors lisez ceci attentivement avant d'envoyer.
Ne soumettez aucun matériel contenant du contenu protégé par des droits d'auteur ou du contenu qui ne vous appartient pas. Tout dans votre dépôt — le fichier .picopixel, les images, les polices, les icônes et toute autre ressource — doit être entièrement votre propre travail original ou du matériel pour lequel vous avez une autorisation explicite de partager publiquement.
En soumettant, vous accordez à PicoPixel la permission d'accéder, de télécharger et de publier publiquement le contenu de votre dépôt dans la galerie de modèles communautaires. Les modèles publiés sont mis à disposition sans restrictions de droits d'auteur ni exigences de licence, afin que n'importe qui puisse les utiliser librement dans ses propres projets, y compris à des fins commerciales. Votre crédit est affiché, mais le modèle lui-même est libre d'utilisation pour les autres.
Cela signifie que vous ne devez soumettre que du travail que vous êtes à l'aise de partager dans ces conditions. Si une partie de votre design utilise une ressource que vous n'avez pas créée — une police, un ensemble d'icônes, une image ou autre chose — et que vous n'êtes pas certain de pouvoir la partager librement et sans restriction, retirez-la avant de soumettre. Dans le doute, abstenez-vous : un modèle propre est bien plus utile aux autres qu'un modèle qui devra être retiré plus tard.
PicoPixel peut supprimer du contenu qui porte atteinte aux droits de tiers. Consultez les Conditions d'utilisation.
Ce qui se passe ensuite
Après votre soumission, l'équipe PicoPixel clone votre dépôt et examine le modèle. La révision vérifie que le fichier .picopixel s'ouvre correctement, que les images et le README sont appropriés, et que la soumission respecte les Conditions d'utilisation.
L'équipe peut vous contacter si quelque chose nécessite une clarification ou une correction. Une fois qu'il passe la révision, le modèle est publié dans la galerie de Modèles avec votre crédit et votre README comme description. De là, n'importe qui peut l'ouvrir comme point de départ pour son propre design.
Conservez votre dépôt après la soumission. Si vous devez mettre à jour votre modèle plus tard — corriger un bug, changer une image, ou améliorer la description — vous pouvez mettre à jour le dépôt et en informer l'équipe.
Si un modèle publié doit un jour être corrigé ou retiré (le vôtre ou celui de quelqu'un d'autre), consultez Comment signaler du contenu.
Où aller ensuite
- Galerie de Modèles : parcourez les modèles communautaires
- Comment soumettre un pet : partagez un sprite animé à la place
- Comment signaler du contenu : signalez un problème avec un pet ou un modèle
- Conditions d'utilisation : les règles qui s'appliquent aux soumissions