Use this command to install Bright Kitchen Print Bridge:
winget install --id=BrightKitchen.PrintBridge -e
Bright Kitchen Print Bridge is a local print bridge service designed to streamline printing operations for receipt printers in Bright Kitchen's KDS (Kitchen Display System) environments. It provides a reliable solution for validating full printing flows before integrating with KDS, ensuring seamless operation of receipt printers.
Key Features:
Local Queue and Adapter Runtime: Manages jobs and printers locally using a durable JSON store.
Chrome Native Messaging Host: Facilitates communication between Chrome extensions and the print bridge service via local named pipes.
Supported Printers: Works with popular models such as Epson TM-T20III, TM-m30 Series, Star TSP100 (LAN/Wi-Fi), BIXOLON SRP-350III, DuraPos DPT100-URE-BK, and Generic ESC/POS printers.
Command-Line Tools: Includes a CLI for operator interactions and diagnostics to troubleshoot printing issues efficiently.
Installer and Setup: Delivered as an NSIS installer (BKPrintBridgeSetup.exe) with optional configurations for vendor drivers and Chrome extension integration.
Audience & Benefit:
Ideal for Bright Kitchen partners operating receipt printers in KDS environments, this tool ensures reliable printing operations with minimal setup complexity. It simplifies the process of validating print jobs, managing local queues, and diagnosing issues, reducing downtime and improving operational efficiency.
Bright Kitchen Print Bridge can be installed via winget, making it easy to deploy in production environments.
README
Bright Kitchen Print Bridge
Standalone local print bridge for Windows, built to validate full printing flow before wiring into KDS.
Delivered binaries
bk-bridge-service.exe: local queue + adapter runtime.
bk-native-host.exe: Chrome Native Messaging host.
bk-bridge-cli.exe: operator CLI.
bk-bridge-doctor.exe: diagnostics CLI.
bk-printer-fix.exe: BK Printer Fix local rescue wizard for Epson TM-T20II Ethernet.
BKPrintBridgeSetup-.exe: one-click Windows installer (NSIS).
BKPrinterFixSetup-.exe: one-click Windows installer (NSIS) for BK Printer Fix.
Supported printer families (profiles)
Epson TM-T20III
Epson TM-T20II
Epson TM-m30 Series
Star TSP100 (LAN/Wi-Fi)
BIXOLON SRP-350III
DuraPos DPT100-URE-BK
Generic ESC/POS
SUNMI NT311
Runtime architecture
Service persists jobs/printers in a local durable JSON store (data/bridge-store.json).
Native host forwards Chrome messages over local named pipe.
Adapters:
raw_tcp (production-ready now)
winspool (Windows only)
sunmi_cloud (optional profile)
BK Printer Fix is a second optional Windows product in the same repo:
simple local browser wizard UI
reusable Windows adapter/helper-IP modules
reusable Epson WebConfig rescue modules
bridge save/test actions through the existing bridge IPC/store path
BK Printer Fix
BK Printer Fix is the operator-facing MVP for Epson TM-T20II Ethernet rescue.
It detects active Windows adapters.
It can temporarily add a helper IP on the selected adapter.
It tries Epson WebConfig over HTTPS first, then falls back to HTTP if the printer firmware does not answer on HTTPS.
It recommends DHCP plus router reservation.
It verifies final TCP 9100 reachability before saving into the bridge.
Local development launch:
npm run printer-fix
add -- --no-browser if you only want the local URL
The bridge can report when chrome.exe is off. This is report-only: it does not create shortcuts, change Chrome policy, change Windows power settings, or repair Chrome.
creates the visible Bright POS desktop and all-users Startup shortcuts
registers \BrightKitchen\BrightKitchenBrightPOSChromeStartup so Chrome starts the Bright POS extension app after Windows boots
Setup proof is written under %ProgramData%\BrightKitchen\PrintBridge\setup-logs.
Local internet alarm
The bridge can also raise a local alarm on the Windows computer when internet connectivity is down. This is local-only: no Slack, no backend relay, and no automatic repair.
Enable it in %ProgramData%\BrightKitchen\PrintBridge\.env:
BK_BRIDGE_INTERNET_ALARM_ENABLED=true
BK_BRIDGE_INTERNET_ALARM_INTERVAL_MS=60000
BK_BRIDGE_INTERNET_ALARM_GRACE_MS=180000
BK_BRIDGE_INTERNET_ALARM_REPEAT_MS=300000
BK_BRIDGE_INTERNET_ALARM_MESSAGE_SECONDS=60
The alarm uses internet probe URLs, then shows a Windows msg.exe popup and attempts a short local sound. Alarm proof is written to %ProgramData%\BrightKitchen\PrintBridge\logs\internet-alarm-events.jsonl.
Optional TeamViewer Host support
TeamViewer Host can be included in the Windows setup for faster partner support. It is optional in the installer UI, recommended by default, and installed in warning mode so bridge installation is not blocked if TeamViewer setup or assignment fails.
Build with TeamViewer Free Host download enabled:
$env:BK_TEAMVIEWER_DOWNLOAD_URL="https://dl.teamviewer.com/download/version_15x/TeamViewer_Host_Setup.exe"
$env:BK_TEAMVIEWER_DEVICE_ALIAS="BrightKitchen-%COMPUTERNAME%"
npm run build:setup
The Free path installs TeamViewer Host and records the TeamViewer ID for manual pairing during support. Automatic assignment to a managed TeamViewer console requires a managed/custom Host MSI:
$env:BK_TEAMVIEWER_MSI="C:\Path\To\TeamViewer_Host.msi"
$env:BK_TEAMVIEWER_CUSTOM_CONFIG_ID=""
$env:BK_TEAMVIEWER_ASSIGNMENT_ID=""
$env:BK_TEAMVIEWER_DEVICE_ALIAS="BrightKitchen-%COMPUTERNAME%"
npm run build:setup
Notes
This project is intentionally standalone from KDS. No KDS code changes are required for validation.
For customer-owned PCs, use scripts/windows/install-all.ps1 as the setup baseline.
Driver inventory and hashes: docs/DRIVER_PACK.md.
BK Printer Fix operator workflow: docs/BK_PRINTER_FIX_RUNBOOK.md.
If KDS is loaded after bridge install, run C:\Program Files\BrightKitchen\PrintBridge\register-native-host.ps1 -AutoDetect -InstallDir "C:\Program Files\BrightKitchen\PrintBridge" once to refresh allowed origins.