Before scanning, please ensure
your scanner is configured to match one of the options below:
⚠️ User Responsibility: Scanner Hardware
Configuration
To mitigate OS-level risks, it is the user's sole responsibility to ensure their scanner
hardware is configured to disable the transmission of control characters and GUI/Modifier
keys. Do not scan unknown QR codes.
Data is processed locally in the browser. No information is uploaded.
All secure data for session collected. Please enter the password.
Troubleshooting / Q&A
Q: Scanned text is leaking into the browser's URL bar (search bar).
A: This happens when the browser window loses focus during a scan. Please try the following:
Install as Standalone App (PWA) — Recommended: Hosting this tool on a server (Intranet or Local) allows you to install it as a PWA. This removes the URL bar entirely and prevents leakage. (Refer to the guide below for steps)
Ensure Focus: Before scanning, click the "Waiting for Scan..." area. Ensure the border is pulsing blue.
Scanner Configuration: Ensure your scanner hardware is set to "Alt Numpad (Universal) Mode".
Q: How do I install this as a Standalone App (PWA)?
A: Installing as a Standalone App (PWA) provides a native app experience, removes the browser's URL bar, and enables "Offline Ready" features. Follow these steps:
Step 1: Establish a Secure Hosting Context
PWA features (Standalone Mode and Service Worker lifecycle) require a Secure Context. Access via the file:// protocol disables these critical security layers.
Institutional Server (Primary Recommendation): Deploy the Reader files to your organization's internal web server (Intranet/Portal). This ensures Host Isolation and allows the utility to be installed as a standalone PWA across all authorized endpoints.
Workstation-Level Listener (Localhost): If a central server is unavailable, initialize a local secure context (e.g., via Python) to facilitate PWA installation:
cd /path/to/INFOBRIDGE-Reader
python3 -m http.server 8080
Once running on a server, use the browser's menu to install:
Chrome / Edge: Click "Install" in the address bar or ... > Save and Share > Install.
Safari (Mac): Go to File > Add to Dock, or Share > Add to Dock.
Safari (iOS): Tap Share > Add to Home Screen.
IT Admin Support: Setting up an internal server or using the terminal often requires administrative privileges. Please contact your IT Administrator to facilitate the deployment or if scanner input continues to leak into the URL bar (e.g., to configure "Kiosk Mode" or adjust OS-level HID settings).