BadgeBadger
Sign inStart free

Getting started

Install the Print Agent

A small desktop helper that runs in the background on the computer your card printer is plugged into. Installing it once per workstation is the difference between popup-print and silent one-click printing.

Why this exists

Browsers don’t expose a “send this PDF to a specific printer” API. The Print Agent fills that gap: it runs a tiny local HTTP listener on port 9988 that BadgeBadger talks to when you click Print. The result is a one-click, no-dialog print. Without the agent you get a popup window and the OS print dialog every time: usable, but slower.

Windows

  1. Open Settings → Printers → One-click printing setup on hq.badgebadger.app and click Download for Windows. (Direct link: GitHub releases.)
  2. Choose BadgeBadger.Print.Agent_x.y.z_x64-setup.exe (NSIS installer) or the .msi if your IT department prefers MSI.
  3. Run the installer. Windows SmartScreen may show a “Windows protected your PC” warning for new versions; click More info → Run anyway (this is normal for un-EV-signed Tauri apps).
  4. The agent will install SumatraPDFalongside itself if it’s not already on your PATH. SumatraPDF is the bridge between PDF and the Windows print spooler. Stock Windows’s default PDF handler (Edge) can’t print to a named queue silently, so we bundle it.
  5. The agent should auto-launch and add itself to your login items. Look for the badger icon in the system tray.

macOS

  1. Open Settings → Printers → One-click printing setup and click Download for Mac, or grab BadgeBadger.Print.Agent_x.y.z_universal.dmg from GitHub releases. One download works on both Apple Silicon and Intel Macs.
  2. Open the .dmg and drag BadgeBadger Print Agent onto the Applications folder next to it.
  3. Open the app from Applications. macOS asks whether you want to open an app downloaded from the internet; click Open. The agent is signed and notarized by Apple, so that’s the only prompt.
  4. PDFs print through CUPS (lp), which is built into macOS, so there’s no extra helper to install.
Seeing “Apple could not verify…”? That copy was downloaded before the agent was notarized in October 2026. Delete it and download the agent again. Updates are also checked against BadgeBadger’s own signing key before they install.

What the agent does on your machine

  • Listens on http://127.0.0.1:9988 for print requests from your browser.
  • Enumerates your installed printers and reports them to BadgeBadger so the picker can show them.
  • Polls BadgeBadger every couple of seconds for cross-machineprint jobs you might have dispatched from a phone or another workstation. Idle-backs off to 30 seconds when nothing’s queued.
  • Stores a single 256-bit token on disk to authenticate against the cloud dispatch endpoint. No employee data is stored on the workstation.

Uninstall

Windows: standard Add/Remove Programs. macOS: drag the app from Applications to the Trash. The agent leaves a small token file behind in your app-data directory; you can delete the BadgeBadger folder there too if you want a clean slate.