Support
Most answers are below. If yours isn't, write to
First run
- Mac: open the dmg, drag LibraScan into Applications, launch it. It appears in the menu bar (a keyboard icon), not in the Dock. Click “Grant Permission…” and enable LibraScan under System Settings → Privacy & Security → Accessibility. macOS will also ask once about Local Network access — allow it.
- iPhone: open LibraScan and tap the keyboard icon (“Type to Mac”) on the scan screen. When your Mac appears in the list, tap it and click “Allow” in the dialog on the Mac.
- Try it: open Notes or any text field on the Mac and scan a code with the iPhone. The content should appear at the cursor and the iPhone banner should say “Typed on Mac”.
The Mac doesn't show up
- Make sure LibraScan is running on the Mac (keyboard icon in the menu bar) and isn't already connected to another iPhone — it serves one at a time.
- Both devices need Wi-Fi and Bluetooth on. The same router isn't required, but both radios off won't work.
- iPhone: Settings → Privacy & Security → Local Network — make sure LibraScan is allowed. After a first refusal iOS won't ask again; this is the only place to change it.
- Mac: System Settings → Privacy & Security → Local Network, same check.
- Some office networks isolate devices from each other. A phone hotspot, or a peer-to-peer link (toggle the Mac's Wi-Fi off and on), usually gets around it.
Connected, but nothing is typed
- The banner says “Mac not authorized to type”: go back to Accessibility on the Mac and confirm LibraScan is checked. After updating or moving the app, it occasionally needs to be removed and re-added.
- The banner says “Typing paused on Mac”: the “Pause typing” switch in the Mac menu is on. Turn it off.
- Password fields, terminals in Secure Input mode, and some remote-desktop sessions block all synthetic keystrokes — USB barcode scanners included. Try an ordinary text field.
- Characters arrive out of order or go missing: raise “Keystroke interval” in the Mac settings (3 ms by default; slower apps want 10 ms or more).
Disconnects and reconnects
- Locking the iPhone or sending the app to the background disconnects on purpose; it reconnects to the last Mac when you come back.
- Codes scanned while disconnected are queued (up to 50) and replayed in order on reconnect. Turn that off in the “Type to Mac” panel if you'd rather they weren't.
- To switch Macs, tap “Disconnect” in the panel and the list comes back.
History and export
- History supports search and swipe-to-delete; the trash button clears everything and can't be undone.
- Export produces one TXT file (time, symbology and content per record) and hands it to the share sheet.
Uninstalling
- Mac: quit LibraScan and drag it to the Trash. For a clean sweep, also remove it from the Accessibility and Local Network lists in System Settings.
- iPhone: delete the app; the local history goes with it.
Contact
Email . Include the iOS and macOS versions and the exact message you see — it gets things solved faster.