Sheet G — Clients

Things people built on it

Every one of these talks to Greenlight over the local API and wears your build’s colour. Each was made by somebody in an evening or a weekend, is open source, and is theirs — the gallery lists it, and never vouches for it.

List yours Build one first

G.1 — 12 clients

TestStrip

Makes every light in the room lie on command. More fun than a cat, and it comes when called.

You could check your shiny new client actually goes red by breaking the build on purpose. Your team would love that. Or you could press a button. Five pads and a toggle: LIVE, grey, green, amber, red, and BUILDING for when you want blinking too. Press one and every light Greenlight drives, from the tray icon to the lamps to every attached client, agrees with you, whatever the pipeline thinks. A lie with a very convincing glow. Close the strip and the hold goes with it, so a crashed tester can't leave your light fibbing all afternoon. Reality comes back. It's usually worse.

by The Meddling Idiotan eveningC#SDK MIT windows verified 2026-09-24 on 1.0.28

Source

Blame

Invisible until someone breaks the build. Then their name, across every monitor you own.

It does nothing. No widget, no colour, nothing sitting in the corner being green at you. It waits. Then a pipeline breaks and it throws the culprit's name across every screen, BROKE THE BUILD! in letters the whole room can read, with a taunt underneath about what they've done this time. Twelve seconds later it tidies itself away, because a notice that never leaves is just wallpaper. Repeat offenders can be given taunts of their very own. They've earned them.

by The Meddling Idiotan eveningC#SDK MIT windows verified 2026-09-23 on 1.0.28

Source Download

Tower

Little people build a tower when it is green, it sways when yellow, and falls down when red.

A tiny crew builds a tower on your taskbar, one course of bricks at a time, for as long as the build stays green. They work faster while a CI run is going, and a flag goes up when it is finished. Yellow means tools down: everyone stops and stares up while the tower sways, further the taller it got. Red brings it all down, bricks bouncing into a heap, and the crew runs around screaming "WHO BROKE IT?!" until the pipeline is fixed. Then somebody says "Right. Again." and they start over from the ground. Break the build and you lose the tower.

by Richelle Lanphear (Meddling Idiot's Wife)an eveningC#SDK MIT windows verified 2026-09-21 on 1.0.24

Source Download

Cursor

Because you were going to look at your cursor anyway.

A halo round your mouse cursor in the colour of your build: green while it passes, amber while a pull request waits, red while it's broken, breathing while it runs. The real cursor is never touched — it's a click-through window that follows the mouse, so nothing needs putting back when you quit. A reference consumer of the Greenlight SDK, in which the whole integration is about twenty lines.

by The Meddling Idiotan eveningC#SDK MIT windows verified 2026-09-20 on 1.0.24

Source Download

Logo

A logo. On your desktop. That glows. Green when the build passes, red when it doesn't.

Your logo on the desktop, lit by your CI — green while everything passes, yellow while a pull request wants you, red when a pipeline breaks. The glow is cut from the picture's own alpha channel, so it's the shape of your logo instead of a rectangle behind it. Bring any PNG. A reference consumer of the Greenlight SDK, in which the whole integration is about twenty lines.

by The Meddling Idiotan eveningC#SDK MIT windows verified 2026-09-20 on 1.0.24

Source Download

Rubber Ducky

Rubber duck debugging, except the duck already knows what you did.

A rubber duck on your desktop, lit by your CI: green while everything passes, yellow while a pull request wants you, and red with horns when a pipeline breaks. He quacks in a speech balloon rather than out loud, because open-plan offices are a thing. A reference consumer of the Greenlight SDK, in which the whole integration is about twenty lines.

by The Meddling Idiotan eveningC#SDK MIT windows verified 2026-09-20 on 1.0.24

Source Download

Cars

Rush hour on your taskbar, conveniently caused by whoever broke the build.

Little cars cruise along your taskbar while the build is green, blissfully unaware. Amber slows them to a crawl and they start honking BEEP BEEP, as if that ever helped. Red stops them dead at the light, and the longer the build stays broken the longer the queue gets, until the road is one long monument to your mistake. Fix it and they drive off one at a time, no hard feelings. No Greenlight running? They park. Five cars by default, and the road can run on, across or under your taskbar.

by The Meddling Idiotan eveningC#SDK MIT windows verified 2026-09-19 on 1.0.23

Source Download

EdgeLight

Two pixels of build status. We'd apologise for the excess, but there isn't any.

Other clients get cars, swords and explosions. This one gets a line. One to five pixels along any edge of your screen, green while everything passes, amber while a pull request sulks, breathing gently while a build runs. No window, no clicks, no desk space, no personality. You'll forget it's there, which is the point. Only a broken build earns a little drama: an old rotating hazard light slides out of the edge and spins until someone fixes it. Too much? Switch it off and enjoy your line.

by The Meddling Idiotan eveningC#SDK MIT windows verified 2026-09-19 on 1.0.23

Source Download

Laser Sabre

A familiar-looking sword. Any resemblance to a certain galaxy is purely coincidental.

A sword stands on your desktop and switches sides with your build: a brushed-steel hilt burning green while everything passes, a brass one in amber when a pull request wants you, and a dark crossguard glowing red when someone breaks the pipeline. We won't name names. With no Greenlight to ask, the blade goes in and the hilt stays, so it looks switched off rather than crashed. Stand it upright, lean it, or lay it across the screen. Can you swing it? No. It's a picture. Calm down.

by The Meddling Idiotan eveningC#SDK MIT windows verified 2026-09-19 on 1.0.23

Source Download

Lava Light

A 70s lava light, because your build status deserved a shag-carpet makeover.

Groovy wax drifts about in green while everything passes and amber while a pull request waits, and the whole thing breathes while a build runs, man. Break the build and it hits a rolling boil, hotter bulb and angrier wax, until you fix it. It even takes a few seconds to warm up, just like the real thing, because authenticity matters. With no Greenlight running it sits there cold and grey, like a lava light at a garage sale. Move it, resize it, and decide how lively the wax gets.

by The Meddling Idiotan eveningC#SDK MIT windows verified 2026-09-19 on 1.0.23

Source Download

Nuclear Fallout

A calm, glowing trefoil. Right up until somebody breaks the build.

It sits on your desktop minding its own business: green while everything passes, yellow while a pull request wants you, pulsing while a build runs. Then a pipeline breaks and it goes off. White flash, fireball, shock wave, mushroom cloud, the works. Proportionate? No. Satisfying? Very. When the dust settles a small red trefoil keeps glowing until someone cleans up the fallout. With no Greenlight running it goes grey. Move it, resize it, and crank the glow if your desk needs more drama.

by The Meddling Idiotan eveningC#SDK MIT windows verified 2026-09-19 on 1.0.23

Source Download

Wallpaper

Your entire desktop, turned the colour of your build. Subtle, it is not.

Green when everything passes, amber when a pull request wants you, red when a pipeline breaks, grey when Greenlight isn't running. Four pictures and that's your lot. It ignores builds starting, because a wallpaper that changed on every push wouldn't be a status light, it would be a strobe, and nobody wants that. It's also the one client that borrows something of yours, so it saves your real wallpaper to disk first and puts it back when you quit. Your cat photo is safe.

by The Meddling Idiotan eveningC#SDK MIT windows verified 2026-09-19 on 1.0.23

Source Download

Listed means the manifest passed the checks and a person looked at the page — not that the code was reviewed. Each client is its author’s. Something wrong with a listing? Open an issue.

G.2 — Build your own

Your app, wearing your build’s colour

Greenlight already polls the providers, holds the tokens and decides what colour the day is. The SDK hands your app that verdict live, over a named pipe. No API keys, no polling, no retry loop, and nothing to break when Greenlight isn’t running — your app just waits for it.

Every client above started the same way: fork CarsClient, delete the cars, draw something worse.

MIT licensed, no dependencies, net8.0 and net10.0. Not .NET? The pipe protocol is documented too.

Read the spec Fork CarsClient Get the package

dotnet add package MeddlingIdiot.Greenlight.Sdk

await using var greenlight = new GreenlightClient();

greenlight.Changed += (_, e) =>
    Paint(e.Snapshot.Status, e.Snapshot.IsBuilding);

await greenlight.StartAsync();

// That's it. Go draw a duck.

G.3 — Yours next

An evening to build, half an hour to list

Build it

Fork CarsClient, delete the drawing, draw your own. The spec is short and the SDK has no dependencies.

List it

Run the capture tool: frame your client, take the still, record the loop, answer five questions. It writes the listing directory. Open a pull request. It appears here within the hour of being merged.

The Greenlight capture tool over a desktop: a green frame around the Greenlight wallpaper with everything outside it dimmed, a Frame your client panel with Take the poster, Record a clip and Whole screen buttons, and a strip of Live, Grey, Green, Amber, Red, Blinking and Auto buttons in the corner — The capture tool, mid-shot

Drag the frame over your client — it’s a real hole, so you can keep clicking your app through it. Press a colour in the corner strip and every indicator on the machine follows, so the poster shows red without breaking a build. Enter takes the still, Record a clip takes the loop, and the five questions after that write the listing for you.

cd greenlight-clients/capture dotnet run

Before you open the pull request

Original artwork only, described by function rather than by franchise.

Every check the listing has to pass, and the reason for each, is in CONTRIBUTING.md. Five minutes there saves a round of review.

Read CONTRIBUTING.md