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, & 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 & 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 & 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-<MAC></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 & 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>