sethserver.com Subscribe
Festive holiday gift boxes illustration with red, teal, and orange wrapped presents with decorative bows, snowflakes, and ornaments on winter background.

Seth's Super Awesome Secret Santa Gift Exchange People Picker – A Privacy-First Secret Santa Generator That Runs in Your Browser

By Seth Black • Updated: September 17, 2026

Programming · 3 min read

Like this kind of writing? Get one email a week with notes on startups, AI, and the occasional strong opinion about Python: subscribe to the newsletter.

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.

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:

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:

  1. Add participants by name
  2. Add restrictions
  3. Press the button and generate matches

Restrictions are for the classic cases:

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:

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

Share this post
Newsletter

One email, once a week.

Notes on databases, systems, and the occasional strong opinion about Python. No spam, unsubscribe anytime.

Seth Black
Written by

Seth Black

Engineer and founder based in Texas. Writes about databases, AI, and running things in production. Embeds in small teams as lead engineer.

More from Programming

View all →
Programming

What's the Differences Between Relational, NoSQL, Vectors, and Caches

Apr 14, 2026
Programming

Git and Source Control in AI Land

Apr 14, 2026
Programming

Domains, DNS, and why it feels fragile

Apr 14, 2026