onlyn00bs-badge

OnlyN00bs: a DEF CON 34 friend-finder badge. ESP32 firmware, Web Bluetooth setup app, printable case
git clone https://git.virtualshack.io/onlyn00bs-badge.git
Log | Files | Refs | README | LICENSE

index.html (21510B)


      1 <!DOCTYPE html>
      2 <html lang="en">
      3 <head>
      4 <meta charset="utf-8">
      5 <meta name="viewport" content="width=device-width, initial-scale=1">
      6 <title>onlyn00bs badge</title>
      7 <meta name="description" content="OnlyN00bs — a DEF CON friend-finder badge. Setup, screens, battery safety, and what it broadcasts.">
      8 <meta name="color-scheme" content="dark light">
      9 <meta property="og:title" content="onlyn00bs badge">
     10 <meta property="og:description" content="A DEF CON friend-finder badge. Setup, screens, battery safety, and what it broadcasts.">
     11 <meta property="og:type" content="website">
     12 <meta property="og:site_name" content="virtualshack">
     13 <meta property="og:url" content="https://badge.virtualshack.io/">
     14 <!-- og:image MUST be an absolute URL — Discord, Slack and Twitter all refuse to resolve a
     15      relative one, and the card silently renders with no image. 1200x630 (1.91:1) is the
     16      shape those unfurlers crop to; feeding them the raw 4:3 photo means each platform
     17      picks its own crop. -->
     18 <meta property="og:image" content="https://badge.virtualshack.io/assets/img/og-badge.jpg">
     19 <meta property="og:image:type" content="image/jpeg">
     20 <meta property="og:image:width" content="1200">
     21 <meta property="og:image:height" content="630">
     22 <meta property="og:image:alt" content="Seven OnlyN00bs badges in coloured 3D-printed cases, screens lit showing the finder, points, report, best-friends, home and battery views.">
     23 <!-- Without summary_large_image, Twitter/X and some clients render a small square thumbnail
     24      instead of the wide card. -->
     25 <meta name="twitter:card" content="summary_large_image">
     26 <meta name="twitter:title" content="onlyn00bs badge">
     27 <meta name="twitter:description" content="A DEF CON friend-finder badge. Setup, screens, battery safety, and what it broadcasts.">
     28 <meta name="twitter:image" content="https://badge.virtualshack.io/assets/img/og-badge.jpg">
     29 <!-- ?v= must match CACHE in sw.js — bump BOTH on any content change. index.html is served
     30      no-cache but /assets/ is not, and Cloudflare stretches it further (origin says
     31      max-age=3600, the edge served 14400), so without a version in the URL a CSS change is
     32      invisible to visitors for hours after a deploy. A new query = a new edge cache key =
     33      it lands immediately. Safe for offline: sw.js matches with ignoreSearch, so this still
     34      resolves to the precached bare URL. -->
     35 <link rel="stylesheet" href="assets/badge.css?v=48">
     36 <link rel="icon" type="image/svg+xml" href="assets/icon.svg">
     37 <link rel="manifest" href="manifest.webmanifest">
     38 <meta name="theme-color" content="#212121">
     39 </head>
     40 <body>
     41 <main class="wrapper" id="top">
     42 
     43   <h1>// onlyn00bs</h1>
     44   <p class="tagline">a friend-finder badge for def con 34 · firmware v1.10</p>
     45   <p class="small muted"><a href="https://virtualshack.io/">virtualshack.io</a> / badge</p>
     46 
     47   <!-- generated from the gallery manifest: the first row, once there are photos -->
     48   <!-- gallery-preview:begin -->
     49   <h2 id="photos">// photos</h2>
     50   <div class="gallery gallery-preview">
     51     <figure>
     52       <a href="gallery/" data-w="1600" data-h="1200"><img src="assets/gallery/thumbs/dc34-01.jpg" alt="A green OnlyN00bs badge on the finder screen beside the official DEF CON 34 badge and a challenge coin, with a purple foot charm on the case"
     53            width="720" height="540" loading="eager" decoding="async"></a>
     54     </figure>
     55     <figure>
     56       <a href="gallery/" data-w="1234" data-h="929"><img src="assets/gallery/thumbs/dc34-02.jpg" alt="A hand holding a purple OnlyN00bs badge on the finder screen, with a green badge on a lanyard behind it"
     57            width="720" height="542" loading="eager" decoding="async"></a>
     58     </figure>
     59     <figure>
     60       <a href="gallery/" data-w="929" data-h="1238"><img src="assets/gallery/thumbs/dc34-03.jpg" alt="A lavender badge with foot and gummy-bear charms, its finder screen listing five nearby badges"
     61            width="540" height="720" loading="eager" decoding="async"></a>
     62     </figure>
     63   </div>
     64   <p class="small"><a href="gallery/">all photos →</a></p>
     65   <!-- gallery-preview:end -->
     66 
     67   <p style="text-align:center"><a class="cta purple" href="update/">Update my badge →</a></p>
     68   <p style="text-align:center"><a class="cta" href="provision/">Set up my badge →</a></p>
     69 
     70   <!-- Changelog. Newest first, CAPPED AT THE 3 MOST RECENT — add to the top and drop the
     71        bottom entry, so this stays a glance and never grows into a wall. Older entries live
     72        in git history, not here. Badge changes and page corrections both land in it, because
     73        from a reader's side "the badge does something new" and "this page was wrong" are the
     74        same question: is what I read last time still true? Keep entries to one line and
     75        user-facing (what changed for them, not which commit did it). -->
     76   <div class="note log">
     77     <p><b>What's new</b> <span class="small muted">— newest first</span></p>
     78     <ul class="small">
     79       <li><b>2026-10-15</b> · <b>Firmware update guide</b> — <a href="update/">update your badge</a>
     80         over USB and keep your handle, points and log. Badges flashed before 2026-08-05 need it
     81         to get <code>Badge Settings → Power → Deep sleep</code>.</li>
     82       <li><b>2026-10-10</b> · <b>iPhone setup works now</b> — open the setup page in
     83         <a href="https://bluefy.app/">Bluefy</a>, an iOS browser with Web Bluetooth. (s/o Vale)</li>
     84       <li><b>2026-09-26</b> · <b>The badge is open source</b> — firmware, setup app, this site,
     85         and the case models. <a href="#source">Source + license</a>.</li>
     86     </ul>
     87   </div>
     88 
     89   <nav class="toc">
     90     <ul>
     91       <li><a href="#what">// the concept</a></li>
     92       <li><a href="#hardware">// the hardware</a></li>   
     93       <li><a href="#software">// the firmware</a></li>            
     94       <li><a href="#case">// the case, lanyard, &amp; accessories</a></li>
     95       <li><a href="#source">// the source</a></li>
     96       <!-- the link appears once the gallery has photos -->
     97       <!-- gallery-link:begin -->
     98       <li><a href="gallery/">// photos</a></li>
     99       <!-- gallery-link:end -->
    100       <li><a href="#setup">// setup</a></li>
    101       <li><a href="#screens">// usage</a></li>
    102       <li><a href="#button">// the button</a></li>
    103       <li><a href="#battery">// battery &amp; safety</a></li>
    104       <li><a href="#trouble">// troubleshooting</a></li>
    105       <li><a href="update/">// updating the firmware</a></li>
    106       <li><a href="#privacy">// privacy</a></li>
    107     </ul>
    108   </nav>
    109 
    110   <h2 id="what">// the concept</h2>
    111 
    112 <p>OnlyN00bs is not just an amateur badge project for DefCon 34, it's an amateur badge project for DefCon 34 brought to life through relentless tokenmaxxing. Could anything be more appropriate for 2026?</p>
    113 
    114 <p>Each badge scans for fellow n00bs and feet enthusiasts, displaying real-time proximity information and beaming your own handle - and ASCII avatar - to those in range. Avatars are user-customizable — faces, name, the lot. Earn made up points. Earn even more made up points by being in range of your friends.</p>
    115 
    116 <p>Designed to be at least mildly secure, every beacon your badge sends and receives over ESP-NOW is HMAC-signed.</p>
    117 
    118   <h2 id="hardware">// the hardware (tl;dr)</h2>
    119 <ul>
    120   <li>ESP32-E (tariffs oof)</li>
    121 <li>2.42" SSD1309 OLED (blue, yellow, and green available in limited quantities)</li>
    122 <li>2000 mAh LiPo battery (12-14 hours per charge observed in testing)</li>
    123 <li>USB-C charging (🫡 🇪🇺 )</li>
    124 <li>A single button</li>
    125 </ul>
    126 
    127   <h2 id="software">// the firmware (tl;dr)</h2>
    128   <li>"Secure" communications using "military-grade encryption" (a.k.a. HMAC signing)</li>
    129   <ul><li><p class="small">Currently clean on OpSec 👊 🇺🇸🔥</p></li></ul>
    130   <li>Beyond simple friend radar, badges track encounters over time, best friend(s), and more.</li>
    131 <ul><li>Points are awarded for time spent near fellow badge-holders, with group bonus multipliers</li></ul>
    132 <li>Customizable integrated virtual ASCII avatar that celebrates milestones, notifies you of low battery (and when to shower), and more</li>
    133 <li>Points-history graph with multiple views</li>
    134 <li>Battery gauge (a little rough) and storage remaining gauge</li>
    135 <li>Fully wireless BLE provisioning via PWA, on-screen pairing code to deter casual interlopers</li>
    136 <li>Points and encounter data export for end-of-Con visualizations (currently in development)</li>
    137   
    138   <h2 id="case">// the case</h2>
    139   <p>Each badge comes in a 3D printed glow-in-the-dark PETG plastic case. There are four primary color options: green, blue, pink (purple?), and multicolor.</p>
    140   <p class="small">Note: ignore the lanyard in this photo, it was used for testing.</p>
    141 
    142   <a class="photo" href="assets/img/all_colors.jpg" target="_blank" rel="noopener">
    143     <img src="assets/img/thumbs/all_colors.jpg" alt="the four case colours side by side: green, blue, pink and multicolour"
    144          width="900" height="677" loading="lazy" decoding="async"></a>
    145   
    146   <p>In order of glowieness ("luminescence" if you're snooty), the green is the brightest, followed by blue/multicolor, and pink:</p>
    147 
    148   <div class="shots">
    149     <a class="photo" href="assets/img/glow_1.jpg" target="_blank" rel="noopener">
    150     <img src="assets/img/thumbs/glow_1.jpg" alt="cases glowing in the dark, first comparison shot"
    151          width="677" height="900" loading="lazy" decoding="async"></a>
    152     <a class="photo" href="assets/img/glow_2.jpg" target="_blank" rel="noopener">
    153     <img src="assets/img/thumbs/glow_2.jpg" alt="cases glowing in the dark, second comparison shot"
    154          width="677" height="900" loading="lazy" decoding="async"></a>
    155   </div>
    156   <h3 id="lanyard">// the lanyard</h3>
    157   <p>Each badge will come with a lanyard:</p>
    158   <a class="photo" href="assets/img/lanyard.jpg" target="_blank" rel="noopener">
    159     <img src="assets/img/thumbs/lanyard.jpg" alt="the lanyard that ships with each badge"
    160          width="900" height="675" loading="lazy" decoding="async"></a>
    161   <h3 id="accessories">// the accessories</h3>
    162   <p>The two openings in the case were designed to be backwards compatible with DC33 OnlyFeet/N00b_Sec Croc jibbitz (and the rest of <a href="https://www.crocs.com/c/jibbitz" target="_blank" rel="noopener">Crocs Jibbitz</a> ecosystem... bring 'em if ya got 'em.). Equally, you can buy them from Crocs, 3D print them, and/or buy them from <a href="https://www.etsy.com/market/jibbitz" target="_blank" rel="noopener">Etsy</a>.</p>
    163   <p>Additionally, a variety of 3D printed accessories (e.g., as seen in the photo above) will be provided for customization. These are still in development (but if you have an idea for something really funny, let me know.):</p>
    164   <a class="photo" href="assets/img/accessories.jpg" target="_blank" rel="noopener">
    165     <img src="assets/img/thumbs/accessories.jpg" alt="3D-printed accessories that clip into the case openings"
    166          width="900" height="675" loading="lazy" decoding="async"></a>
    167 
    168   <h2 id="source">// the source</h2>
    169   <p>The badge is open source: the firmware, the setup app, this site, the parts list,
    170   and the parametric case (STLs included, so you can print one without touching CAD).</p>
    171   <p style="text-align:center"><a class="cta" href="https://git.virtualshack.io/onlyn00bs-badge/">Browse the source →</a></p>
    172   <p class="small muted" style="text-align:center"><code>git clone https://git.virtualshack.io/onlyn00bs-badge.git</code> · <a href="https://git.virtualshack.io/onlyn00bs-badge/releases/">releases</a></p>
    173   <ul>
    174     <li><b>License:</b> MIT for the code; CC BY-SA 4.0 for the case models, docs and photos.</li>
    175     <li><b>Not included: the group key.</b></li>
    176     <li><b>Also not included: anyone's data.</b></li>
    177   </ul>
    178 
    179   <h2 id="setup">// setup</h2>
    180 
    181   <p>You need: the badge, about two minutes, and one of: a computer with <b>Chrome or Edge</b>,
    182   an Android phone, or an iPhone/iPad with <a href="https://bluefy.app/">Bluefy</a>. (Setup uses Web Bluetooth; Safari and
    183   Chrome for iOS don't have it.)</p>
    184 
    185   <ol>
    186     <li><b>Put the badge in setup mode.</b> From the badge: <code>OPTIONS → Badge Settings →
    187       Developer Options → Provisioning Mode</code>. (You can also hold the microcontroller's
    188       <code>BOOT</code> button while powering it on — but that means opening the case, so the
    189       menu is the easier route.)</li>
    190     <li><b>Read the 3-character pairing code</b> off the badge screen (something like
    191       <code>K7Q</code>). This stops strangers from reconfiguring your badge.</li>
    192     <li><b>Open <a href="provision/">the setup app</a></b>, type in your handle, the pairing code, optionally configure an avatar, then hit <em>connect &amp; save</em>.</li>
    193     <li><b>Select your badge</b> from the browser's Bluetooth pop-up. It will show up as
    194       <code>badge-setup-&lt;MAC&gt;</code>. The badge then reboots into normal mode with
    195       your handle set, and its internal clock (used to timestamp your encounters — it isn't
    196       shown on screen) set from your device.</li>
    197   </ol>
    198   <div class="note stop"><p>If that internal clock drifts after a battery swap — your con REPORT
    199   times go "relative" — the same web app has a <em>sync clock only</em> button that re-syncs it
    200   without touching your handle.</p>
    201 </div>
    202 
    203   <div class="note warn">
    204     <p><b>Stuck in setup mode? Hold the badge's button for 5 seconds.</b> A badge in setup mode is
    205     not beaconing and won't see anyone, and will sit there forever. Holding the button
    206     counts down on screen and reboots straight to HOME.</p>
    207   </div>
    208     <p class="small">Note: A badge that has never been set up will name itself something like
    209     <code>n00b-1858</code> on the way out, so that it works immediately.</p>
    210   <h2 id="screens">// usage</h2>
    211 
    212   <p>Seven views, in a loop. Double-tap the button to walk forward through them:</p>
    213 
    214 <pre><code>  double-tap walks down this list          a single tap here does…
    215   ┌──────────────────────────────────────────────────────────────
    216   │ HOME      handle, avatar, points, battery
    217   │ FINDER    who's in range, closest first     page the list
    218   │ REPORT    your con so far
    219   │ POINTS    points over time, as a graph      cycle 5d / 24h / 1h
    220   │ FRIENDS   best-friends ledger
    221   │ BATTERY   charge level                      flip to storage
    222   │ OPTIONS   settings                          move the cursor
    223   └── and wraps back to HOME ────────────────────────────────────
    224 
    225   hold the button 1.5s from anywhere → jump straight to HOME
    226 </code></pre>
    227 
    228   <dl>
    229     <dt>HOME</dt>
    230     <dd>Your handle, your avatar, total points, and battery. The default view.</dd>
    231 
    232     <dt>FINDER</dt>
    233     <dd>Who's in range right now, closest first. <b>Tap</b> to page through the list if
    234       there are more badges than fit. A badge drops off ~15 seconds after its last
    235       beacon.</dd>
    236 
    237     <dt>REPORT</dt>
    238     <dd>Your con so far: an encounter summary, snapshotted when you arrive on the
    239       screen.</dd>
    240 
    241     <dt>POINTS</dt>
    242     <dd>Points over time as a graph. <b>Tap</b> to cycle the window: 5 days / 24 hours /
    243       1 hour.</dd>
    244 
    245     <dt>FRIENDS</dt>
    246     <dd>Your best-friends ledger — who you've actually spent time near, ranked by shared
    247       minutes.</dd>
    248 
    249     <dt>BATTERY</dt>
    250     <dd>Live battery gauge. <b>Tap</b> to flip to the storage readout (how full the
    251       badge's flash is).</dd>
    252 
    253     <dt>OPTIONS</dt>
    254     <dd>Note: In OPTIONS, <b>tap</b> moves the cursor down a row,
    255       <b>double-tap</b> selects it (and double-taps back out).</dd>
    256   </dl>
    257 
    258   <h2 id="button">// the button</h2>
    259 
    260   <p>One button, three gestures:</p>
    261 
    262 <pre><code>   tap          →  do this screen's thing   (page the list, cycle the graph…)
    263    tap tap      →  next screen
    264    hold 1.5s    →  jump back to HOME        (works from anywhere)
    265 
    266    in SETUP MODE only:
    267    hold 5s      →  leave setup, reboot to HOME
    268 </code></pre>
    269 
    270   <p>If you're ever lost, hold the button. You'll land on HOME.</p>
    271 
    272   <h2 id="battery">// battery &amp; safety</h2>
    273 
    274   <p>It's a lithium-polymer pouch cell and we're in the desert. Do the math.</p>
    275 
    276   <ul>
    277     <li><b>Tested runtime:</b> about <b>14 hours</b>. Bring a power bank or charge nightly.</li>
    278     <li><b>Remember</b> that LiPo batteries left empty for more than a few hours can be permanently damaged.</li>
    279     <li><b>Charging:</b> via USB-C, roughly <b>4 hours</b> from empty to full. Charge it on a
    280       hard surface — not on a hotel bed, a couch, or buried in a backpack.</li>
    281     <li><b>Never</b> charge a pack that is hot, puffy, swollen, or has been crushed or
    282       punctured. A swollen pouch is done; stop using it. <b>I'll give you a new one for free.</b></li>
    283     <li><b>Never leave it in a parked car</b>, on a dashboard, or in direct sun. A closed car
    284       in Vegas will cook a pouch cell well past anything it's rated for.</li>
    285     <li>Don't leave it charging unattended.</li>
    286     <li><b>Deep sleep is not "off":</b> a sleeping badge still draws a (very) small amount of power and will die/kill the battery eventually. For longer periods (8+ hours), charge it to roughly half and unplug the battery at the JST connector.</li>
    287     <li>Dead or damaged cells go to battery-recycling (please don't toss them in the trash).</li>
    288   </ul>
    289 
    290   <h2 id="trouble">// troubleshooting</h2>
    291 
    292   <dl>
    293     <dt>The setup page has no "connect" button, or the button does nothing</dt>
    294     <dd>Your browser doesn't have Web Bluetooth. Switch to Chrome or Edge (laptop or
    295       Android) or <a href="https://bluefy.app/">Bluefy</a> (iPhone/iPad).</dd>
    296 
    297     <dt>FINDER shows nobody</dt>
    298     <dd>In order of likelihood: (1) nobody is actually in range — the radio range is in the tens
    299       of meters (and bodies absorb 2.4 GHz), (2) the other badge is in setup
    300       mode, so it isn't beaconing, (3) mismatched builds — if multiple people see
    301       nothing, compare firmware versions on <code>OPTIONS → Whoami</code>.</dd>
    302 
    303     <dt>My REPORT times look wrong or say "relative"</dt>
    304     <dd>There's no clock on screen, but the badge still keeps time internally to timestamp your
    305       encounters — and it has no battery-backed clock, so it gets the time from your phone or
    306       laptop during setup. After a battery swap that can drift; the REPORT view then shows
    307       <em>relative</em> times instead of real ones. Run <em>sync clock only</em> in the setup app
    308       to fix it. Any setup-capable browser works, including <a href="https://bluefy.app/">Bluefy</a> on iPhone.</dd>
    309 
    310     <dt>I'm stuck on the SETUP MODE screen</dt>
    311     <dd><b>Hold the button for 5 seconds.</b> The screen counts down and the badge reboots
    312       to HOME. Works with no app and no network. One catch: it wants a <em>fresh</em> press,
    313       so if you got here by holding <code>BOOT</code> through power-on, let go first, then
    314       hold again.</dd>
    315 
    316     <dt>My badge won't connect over Bluetooth</dt>
    317     <dd>It only advertises while in setup mode. If the browser's chooser is empty, the
    318       badge isn't in setup mode — power-cycle it holding <code>BOOT</code>.</dd>
    319 
    320     <dt>It says the pairing code is wrong</dt>
    321     <dd>The code is 3 characters shown on the badge screen and it changes each time the
    322       badge enters setup mode (the charset deliberately has no
    323       <code>0/O</code> or <code>1/I/L</code>).</dd>
    324 
    325     <dt>The badge says <code>locked, power-cycle</code></dt>
    326     <dd><b>Five wrong pairing codes and the badge shuts its setup gate until it reboots</b>
    327       — that's on purpose, so nobody can sit in range guessing codes at your badge. Power-
    328       cycle it (hold <code>BOOT</code> if you want to go straight back into setup) and
    329       you'll get a fresh code.</dd>
    330   </dl>
    331 
    332   <h2 id="privacy">// privacy</h2>
    333 
    334   <p>It is a radio and DEF CON is full of weird people listening to radios.</p>
    335 
    336   <ul>
    337     <li>Your badge broadcasts <b>your handle in cleartext, once per second</b>, plus a
    338       stable hardware address that doesn't change.</li>
    339     <li>The HMAC signature proves a beacon came from someone with the group key. It
    340       <b>signs, it does not encrypt</b> — anyone sniffing 2.4 GHz nearby can read the
    341       handles and follow a badge around the venue.</li>
    342     <li>So: <b>pick a handle you're happy having in the air</b>, and assume presence is
    343       public.</li>
    344     <li>If you'd rather not be seen, <b>Badge Settings → Stealth</b> turns your broadcast
    345       off. You can still see other badges; they can't see you.</li>
    346     <li>Encounter logs, points, and your best-friends list stay on the badge. Nothing is
    347       uploaded anywhere — the setup app talks only to the badge in front of you, and the
    348       metrics export for post-con visualizations runs in your browser.</li>
    349     <li><b>Nobody can reconfigure your badge over the air.</b> Setup only listens while the
    350       badge is in setup mode.</li>
    351   </ul>
    352 
    353   <p style="text-align:center"><a class="totop" href="#top">↑ back to top</a></p>
    354 
    355   <footer style="text-align:center">
    356     <p>onlyn00bs · def con 34<br/>lab grown in <a href="https://virtualshack.io/">virtualtack's virtualshack</a> with some help from Claude</p><br/>
    357     <p class="small">If something here is wrong or
    358     missing, please let me know.</p>
    359   </footer>
    360 
    361 </main>
    362 <script>
    363   if ("serviceWorker" in navigator) {
    364     addEventListener("load", () => navigator.serviceWorker.register("sw.js").catch(() => {}));
    365   }
    366 </script>
    367 </body>
    368 </html>