Scanner setup
Card Birth Certificates use a flatbed scanner driven straight from the browser, so there's a one-time setup before your first scan.
Already set up and just seeing "Scanner bridge required"? Jump to confirm the bridge is running.
Browser requirement: scanning needs a Chromium-based browser — Chrome, Edge, Brave, or Arc. Safari and other WebKit browsers (including Orion) block web pages from talking to the scanner bridge on your machine and offer no way to allow it.
- 1
Power on and connect the scanner
Connect the scanner you were shipped and power it on. BreakersDNA drives it directly from the browser once CameraSplitter can see it. - 2
Install and open CameraSplitter
CameraSplitter is the same desktop app you already use to split your stream camera for OBS — the scanner bridge rides along inside it, so there's no second app to install. Get it from the Test & Setup page if it isn't installed yet, then open it and leave it running in the background while you scan. - 3
Install the fi-70F scan backend (macOS) or driver (Windows)
On macOS, Ricoh publishes no fi-70F driver at all — CameraSplitter instead drives the scanner through its own open-source scan backend. Run the one-time installer that ships alongside CameraSplitter (install-sane-fi70f.sh— see the in-app Scanner Bridge log for the exact path), then restart CameraSplitter; the fi-70F appears in the bridge once it's connected. If you're on Windowsand the bridge doesn't find your scanner after connecting it, install PaperStream IP from Ricoh's fi Series downloads — Windows' built-in driver support for this scanner is limited. - 4
Linux only — install the scan backend first
On Linux, install SANE and the driverless eSCL backend before opening CameraSplitter:# Debian/Ubuntu sudo apt install sane-utils sane-airscan python3-sane python3-pil # Fedora sudo dnf install sane-backends sane-airscan python3-sane python3-pillow # Arch sudo pacman -S sane sane-airscan python-pillow
- 5
Confirm the bridge is running
With the scanner connected and CameraSplitter open, go back to Create Birth Certificate and hit Retry. It checks for CameraSplitter's scanner bridge running on your own machine — once it's found, you'll get a scanner picker and a resolution (DPI) selector instead of the upload screen.
If Chrome asks whether this site may access devices on your local network, choose Allow — that permission is how the page reaches the bridge on your own machine. Denied it earlier? Re-enable it via the icon left of the address bar → Site settings → Local network access, then retry.
Good to know
- The scanner bridge only listens on your own machine — it's never reachable over your network, so there's nothing to open in a firewall.
- If your company requires the scanner bridge for birth certificates, file upload stays disabled until the bridge is detected — connecting the scanner and retrying is the only way past that screen.
- Bridge not detected after all of this? Confirm CameraSplitter is actually open (not just installed) and the scanner is powered on and connected, then Retry again.
- Card handling rules — DPI, flat on the bed, minimal glare, sharp focus, raw cards only — still apply once you're scanning. The scan screen shows the current list.