Badge Printing Booth

Complete guide for setting up the volunteer badge printing station.

What You’ll Need

Equipment

Tools

Materials / Consumables

Setup

1. Position table, run power and network
2. Set up printer, load badge paper
3. Connect Raspberry Pi to printer via Micro-USB-B to USB-B adapter + USB-B to USB-A cable
4. Connect Pi to network (Ethernet) and TV (Micro HDMI to HDMI adapter)
5. Secure Pi to table with Alien tape
6. Connect Pi power (Micro-USB-B cable) last
7. Wait for boot, verify badge application starts
8. Test print one badge to verify alignment

Paper Loading

1. Remove any plain paper from tray
2. Fan the badge template paper stack
3. Load with correct orientation (print test to verify)
4. Adjust paper guides to fit snugly

Application Controls

Pause / Resume Printing

A toggle button on the main page controls whether the print queue is active:

• Running (green) — badges print automatically as they enter the queue
• PAUSED (red) — queue is held; no badges print until resumed

Use pause when reloading paper, clearing jams, or during breaks.

Printer Management

Printers connect as agents and must be approved before they can receive jobs:

1. Connect the printer and wait for it to appear in the Reports page
2. Approve the printer agent
3. Select the approved printer for badge output

Reset Queue

If badges get stuck in a “leased” state (assigned to a printer but never printed):

• Use the Reset button (POST /api/print/reset) to release all leased badges back to the queue

Undo Last Print

If the last printed sheet had an error (wrong paper, jam, misalignment):

• Use Undo Last Print (POST /api/print/undo-last) to revert the last printed sheet back to queued status
• This automatically pauses the queue so you can fix the issue before resuming

Troubleshooting