It started the way a lot of "small" family tech problems start: someone says, "Hey, can you make a quick thing for this?" and you say yes because you enjoy being helpful and you haven't learned your lesson yet.
More than 10 years ago, my wife's family needed a better way to run their Secret Santa exchange. The usual method was scraps of paper in a hat, vague rules nobody remembered, and someone inevitably drawing their own name and going "yep, this is fine." So I wrote a tiny Python program that did the matching and handled basic restrictions.
That little script ended up becoming one of my most starred GitHub repos, which is funny because I'm prouder of a different project called funny-words. That one is objectively more delightful. But popularity isn't a merit badge. It just means a lot of people have the same annoying problem.
- Old Python repo: python-gift-exchange
- The one I love more: funny-words
The problem with most Secret Santa sites
A while back I tried to find a decent Secret Santa tool to point people at. And wow. A lot of these sites act like you're opening a bank account.
They want:
- Email addresses for everyone
- Signups
- Passwords
- "Invite" flows
- Some vague promise that they won't spam your aunt
For a gift exchange.
This reminds me of a SaaS job I had where the product "used AI" to automate financial tasks, and the big reveal was: it was mostly spreadsheet column mapping and formatting. The marketing was fancy. The reality was Excel with extra steps. Secret Santa apps that demand signups have the same vibe. You're trying to assign names, not launch a social network.
So I made a new version.
A Secret Santa picker that doesn't want your data
I built a free, browser-based version called Seth's Super Awesome Secret Santa Gift Exchange People Picker.
It runs entirely in the browser. No accounts. No emails. No database full of "GrandmaCarol1972@example.com" waiting to get "accidentally" exported.
This is the whole point: this problem doesn't require personal data.
If you want to use it, you can host it yourself, fork it, or just run it locally. The code is on GitHub, like everything else I ship and then refuse to hover over.
How it works (the only three steps you need)
The flow is intentionally boring:
- Add participants by name
- Add restrictions
- Press the button and generate matches
Restrictions are for the classic cases:
- spouses can't draw each other
- roommates can't draw each other
- "don't match these two people because it'll be weird at dinner"
Under the hood, this is a constraint problem. Not a hard one, but still a real one. You're trying to find a permutation where each giver maps to exactly one recipient, and the mapping avoids forbidden pairs.
A lot of people try to brute force this with "shuffle until it works," which is fine for small groups until it suddenly isn't. The moment you add enough restrictions, naive shuffling turns into that friend who says "I'll be there in 5 minutes" and then never arrives.
So the logic needs to:
- track invalid edges (giver - recipient is forbidden)
- avoid self-matches
- avoid duplicate recipients
- detect dead ends and retry intelligently
No, it's not a giant SAT solver. It's just code that takes constraints seriously.
The rule that keeps the surprise intact
One person generates the matches. That person sends each giver exactly one message: the name of their recipient.
That's it.
If everyone can see the whole mapping, you've turned Secret Santa into Spreadsheet Santa. The surprise dies immediately. Keep it simple, keep it quiet, and resist the urge to "add features."
Why I bothered
I like projects that sit at the boundary of digital and real life. Years ago I built a web-based guitar configurator that exported CAD files for CNC cutting, stencils for a plotter, pick lists, QC lists, shipping labels-the whole pipeline from "click a color" to "a physical guitar exists." I built it because we needed it, and because it sounded like a bad idea in the fun way.
This Secret Santa thing is the opposite. It's tiny. It's not glamorous. It's a simple tool that refuses to pretend it's a platform.
Sometimes that's the best kind of software.
-Sethers