Getting started
Pair your computer
Pairing authorizes a specific workstation to receive print jobs from your BadgeBadger account. Pair once per computer; it persists across browser sessions, OS user switches, and incognito.
The one-click way (recommended)
- Open the Print Agent (system tray icon or Applications).
- Click Pair this computer ↗. Your default browser opens to BadgeBadger pre-filled with the agent’s token and this workstation’s hostname.
- If you’re not signed in, sign in. The pairing URL waits.
- Confirm the “Pair this computer?” dialog. You’ll be redirected to Settings → Printers → Print agents.
- Your browser may ask whether BadgeBadger can access other apps and services on this device. Click Allow: that’s how BadgeBadger reaches the agent. The computer then shows with a green “This computer” chip. If you clicked Block, change it from the icon at the left of the address bar.
The legacy way (if your browser is on a different machine)
Some setups use one PC for the printer and a different one for BadgeBadger. In that case the deep link can’t reach the right browser, so paste the token by hand:
- In the agent, open Settings and troubleshooting and click Copy next to the pairing code. Before version 0.7.0 it’s under Use a different browser / manual paste, then Reveal → Copy.
- On the browser machine, open Settings → Printers → Print agents → Pair workstation and paste the token. Save.
Durable pairing
Pairing is stored server-side (in your organization’s agent_devices record). Once a computer is paired, every browser session for any member of your organization can use that printer without re-pasting. Incognito sessions, new browsers, and a different shift worker logging into Windows all work.
Revoke any time. Settings → Printers → Print agents → Paired computers → Revoke on the row you want to disconnect. The agent on that machine keeps running locally but stops being reachable from the cloud.
What gets stored
- The hostname and platform the agent reports (e.g., “Front Desk PC · Windows”).
- A 256-bit bearer token used to authorize print jobs.
- The list of printers the agent sees, refreshed roughly once a minute.
Nothing else: no employee data, no print previews, no usage analytics.