GreenWall : dessiner sur le graphique de contributions GitHub

Le calendrier de contributions comme toile

GreenWall est une application de bureau qui permet de modifier l'apparence de votre graphique de contributions GitHub. Selon le README, vous téléversez une image (PNG, JPG ou SVG), choisissez le nombre de lignes et de colonnes du calendrier, puis sélectionnez un mode de conversion. L'application transforme l'image en heatmap de contributions que vous pouvez placer sur le calendrier. La description du dépôt indique que le but est de dessiner divers motifs sur votre historique de contributions GitHub. Le README ne précise pas si l'application fonctionne sur tous les systèmes d'exploitation, mais il inclut des notes de plateforme pour Windows, Linux et macOS.

Modes d'image et réglages

Deux modes de conversion sont documentés. Le mode Auto est décrit comme adapté à la plupart des photos et images en niveaux de gris, tandis que le mode Binaire est le mieux adapté au texte noir sur fond blanc ou aux dessins au trait. Le guide rapide donne des réglages recommandés pour quatre entrées courantes : texte noir sur fond blanc, photos ou dessins à faible contraste, lignes très fines, photos lumineuses ou bruitées. Les options de réglage incluent l'inversion de luminosité, le seuil, le filtre de mise à l'échelle et la récupération des traits. Le guide recommande également le filtre de mise à l'échelle Nearest pour préserver les bords nets et mentionne qu'augmenter le seuil ou utiliser la dilatation des traits peut aider dans certains cas. Des exemples de conversions réussies et échouées sont inclus dans le README, avec des raisons telles que la surexposition, le faible contraste et un fond bruité.

Dessiner, copier et pousser le résultat

Après vous être connecté avec un jeton d'accès personnel, l'application affiche votre avatar et votre nom dans le coin supérieur gauche. Vous faites glisser le curseur sur le calendrier pour peindre votre motif. Un clic droit bascule entre le pinceau et la gomme, et un contrôle d'intensité du pinceau change la nuance de vert. Un mode de copie permet de sélectionner une zone en glissant, d'appuyer sur Ctrl+C pour copier, puis de coller à un autre endroit avec Ctrl+V ou un clic gauche. Lorsque le motif est prêt, le bouton « Create Remote Repo » ouvre des champs pour le nom et la description du dépôt, ainsi qu'un choix public/privé. En appuyant sur « Generate & Push », l'application crée et pousse le dépôt automatiquement. Le README avertit que GitHub peut prendre de 5 minutes à 2 jours pour afficher les contributions et suggère de garder le dépôt privé tout en activant « Include private contributions ».

Lancement sur Windows, Linux et macOS

Pour Windows et Linux, le README dit de télécharger et d'exécuter l'application directement. macOS est différent car l'application n'est pas signée, ce qui peut déclencher des restrictions de sécurité au premier lancement. Le README fournit deux commandes pour supprimer les attributs de quarantaine : `sudo xattr -cr ./green-wall.app` et `sudo xattr -r -d com.apple.quarantine ./green-wall.app`. Il conseille de les essayer dans l'ordre et de s'arrêter dès que le problème est résolu, et note que ces commandes ne lancent pas automatiquement l'application ; vous devez toujours double-cliquer dessus. Le nom de répertoire dans les commandes est `green-wall.app`, mais l'exemple du README commence par `cd the-directory-where-green-wall.app-is-located`.

Compiler depuis les sources avec Wails

Le guide de développement liste Go 1.24+, Node.js v22+ et Git comme prérequis. Il demande d'installer Wails v2.10.2 avec `go install github.com/wailsapp/wails/v2/cmd/wails@v2.10.2`. Après avoir cloné le dépôt, vous exécutez `cd frontend && npm install`, puis `wails dev` pour le développement et `wails build` pour la compilation. Le chemin de sortie est `build/bin/`. Les métadonnées du dépôt indiquent TypeScript comme langage, mais l'outil de compilation est Wails, qui utilise Go et un frontend web. Le README ne décrit pas d'architecture interne au-delà de ces commandes.

Mentions, avertissement et licence

Le README mentionne trois recommandations publiques. Début novembre, le projet a été recommandé par YiFeng Ruan et présenté dans le numéro 372 de Tech Enthusiast Weekly. Mi-novembre, il a été recommandé par « it咖啡馆 » et présenté dans le numéro 93 de GitHub Weekly Hotspots. En décembre, il a été sélectionné comme « projet intéressant » par HelloGitHub. Le README contient également un avertissement indiquant que le projet est fourni à des fins éducatives, de démonstration et de recherche liées aux mécanismes de contribution GitHub, et que tout usage abusif, par exemple pour falsifier des candidatures à un emploi, relève de la responsabilité de l'utilisateur. Le projet est publié sous licence MIT, copyright 2025 橡皮膏. Cette licence autorise l'utilisation, la copie, la modification, la fusion, la publication, la distribution, la sous-licence et la vente de copies, et précise que le logiciel est fourni « tel quel », sans garantie d'aucune sorte.

Conclusion éditoriale

Le README de GreenWall couvre la conversion d'images, le dessin sur le calendrier et l'envoi du dépôt, et il précise le délai d'affichage des contributions ainsi que la responsabilité en cas d'usage abusif. Le projet est sous licence MIT et utilise Wails pour le développement.

Sources officielles

1. Official README
2. Project repository
3. Release notes