Printers & the Print Bridge

Print receipts, kitchen and bar tickets, and open the cash drawer from a printer in your shop. Download the print bridge for Mac or Windows, pair it with a token, and choose what each printer prints.

The Print Bridge is a small program you run on the computer your printer is plugged into. Qvian runs in the cloud and cannot reach a printer sitting in your shop, so the bridge connects outward to Qvian and passes print jobs the last step — receipts, kitchen tickets, and the cash drawer. You only need it if your printer is connected to a till rather than to Qvian's own server.

Last updated

Why it is needed

Your printer is in your shop. Qvian runs on a server somewhere else. Nothing on the internet can dial into a printer on your counter — that is true whether the printer is plugged in by USB or sitting on your own Wi-Fi, and it is a good thing, because it is what stops strangers printing on it.

The bridge solves it from the inside. It runs on your till and opens a connection outward to Qvian, the same way a browser does. Qvian sends print jobs down that connection and the bridge hands them to the printer. No router changes, no port forwarding, no fixed IP.

One bridge serves every printer at that location — counter, kitchen, and bar.

You may not need this at all

If your receipts already print the way you want, leave this alone. Qvian falls back to your browser's normal print dialog whenever no printer is reachable, and that keeps working. The bridge is for printing straight to a thermal printer without a dialog, and for opening a cash drawer — which a browser cannot do.

Download

One file, nothing to install. Run it on the computer your printer is plugged into — not on any other machine.

On Windows you do not need this. The setup command in the next section downloads the right file for you and avoids the browser warning that comes with an unsigned program. These links are for a Mac, or for a till with no internet access of its own.

Setting it up

How to Connect a Print Bridge (set up print bridge, install print agent, connect printer to cloud)

Do this on the computer the printer is plugged into, not on any other machine. On Windows it is a single command and it asks you nothing.

Required permission: Business unit settings

  1. In Qvian, go to Settings → Printing
  2. Under Print bridge, choose Manage, then Pair
  3. Give the till a name you will recognise, like *Front counter*
  4. Copy the setup command it shows — it appears once and cannot be shown again
  5. On the till, open PowerShell as administrator (right-click Start → Terminal (Admin))
  6. Paste the command and press Enter

Result: It works through five steps and finishes with CONNECTED, followed by the list of printers on that machine. Back in Qvian the bridge shows as connected.

Note: The command carries the pairing code with it, so nothing is typed by hand and it can be sent to whoever is standing at the till.

The command does everything in one go: it tells Windows Defender to leave the folder alone, downloads the bridge without going near a browser, pairs it, and sets it to start by itself whenever the computer does.

Your antivirus may delete it — including weeks later

The bridge is not countersigned by Microsoft or Apple yet, and Defender sometimes decides a program it does not recognise is a threat. Nothing has to change for this to start happening: a routine antivirus update is enough, which is why a bridge that worked on the day it was installed can stop weeks later with no warning. The setup command tells Defender to leave the folder alone before it downloads anything. If your till runs a different antivirus, allow the folder Qvian Print Bridge in its settings too — or ask us and we will do it with you.

It saves your answers in a file called config.json next to the program. You do not need to touch that file.

It now comes back on its own

The bridge only works while it is running, and it used to stop for good at the first restart — silently, because a bridge that was never started looks exactly like one that is simply switched off. The setup command installs it as a scheduled task, so it starts when somebody logs in and restarts itself if it ever stops. You should not have to think about it again.

If the window opens and closes instantly

That is almost always antivirus removing the program before it can run. Use the setup command above rather than opening the downloaded file directly — it clears that first. If it still happens, send us what the command printed and we will tell you which part failed.

Replacing a pairing code

Codes do not expire, but you can replace one at any time — if a till is retired, if a laptop leaves the shop, or if you are simply not sure where a code ended up. In Settings → Printing → Print bridge → Manage, press Revoke beside the bridge. It disconnects immediately and that code stops working for good. Then press Pair for a fresh one and run the new command on the till — it replaces the old pairing in place, with nothing to uninstall first.

On a Mac

There is no one-line setup for macOS yet. Download the file above, then in Terminal run chmod +x and xattr -d com.apple.quarantine on it before running it — a file fetched by a browser arrives without permission to run and marked as quarantined, and macOS will otherwise refuse it. It then asks for the pairing code the same way.

Pointing Qvian at your printer

How to Add a Printer That Uses the Bridge (add usb printer, add network printer, configure receipt printer)

With the bridge running, Qvian can see the printers on that machine.

Required permission: Business unit settings

  1. Go to Settings → Printing
  2. Choose Add printer
  3. For a printer plugged in by USB, choose USB and pick it from the list
  4. For a printer on your network, choose Network and enter its IP address
  5. Give it a name you will recognise, like *Front Counter* or *Kitchen*
  6. Save, then use Test on that row

Result: A test page prints. The printer now appears in the Prints column showing what it is used for.

Note: A printer with nothing routed to it shows an amber Nothing routed here chip — that is a reminder, not an error.

Once a printer exists you can decide what comes out of it on the same page: the customer receipt, each kitchen or bar station's tickets, and which printer the cash drawer is cabled to. See Registers & Reconciliation for how the drawer fits into the day's cash.

Common questions

Do I need the print bridge?

Fix: Only if you want printing without a browser dialog, or you want the cash drawer to open. If your printer is plugged into the same computer Qvian runs on — which is unusual — you do not need it. Everyone using Qvian in the cloud with a printer in the shop does.

Does my printer need to be on the network?

Fix: No. A USB printer works, as long as the bridge runs on the computer it is plugged into. The bridge hands the job to that computer’s own print queue.

What happens if the bridge is not running?

Fix: Receipts fall back to your browser’s print dialog, so you can still give a customer their bill. The cash drawer will not open, because opening a drawer means sending a command to the printer directly.

Does it survive restarting the computer?

Fix: Yes, once it has been set up with the setup command — that installs it as a scheduled task, so it starts when somebody logs in and restarts itself if it ever stops. A bridge installed by running the downloaded file by hand does NOT come back after a restart, and nothing warns you: the first sign is a receipt that will not print. If yours was set up that way, run the setup command again to fix it.

It worked when you installed it and now it does nothing

Fix: Two usual causes. The computer was restarted and the bridge was never set to come back — see above. Or antivirus removed the program, which can happen weeks after it was installed because a routine antivirus update is enough to change its mind. Running the setup command again fixes both: it allows the folder first, then reinstalls.

How do I replace a pairing code?

Fix: Settings → Printing → Print bridge → Manage, then Revoke beside the bridge. It disconnects straight away and that code stops working permanently. Press Pair for a fresh one and run the new setup command on the till — it replaces the old pairing in place, with nothing to uninstall.

Can one bridge serve several printers?

Fix: Yes. One bridge per location serves the counter, the kitchen and the bar. You do not need one per printer.

Is it safe to leave running?

Fix: It only makes an outward connection to Qvian and only accepts print jobs for your own business unit. It does not open any port on your computer and nothing can connect in to it.

The cash drawer does not open, but receipts print

Fix: The drawer opens through the printer it is cabled to, so check that the correct printer is chosen under Cash drawer in Settings → Printing. Some drawers also need a longer pulse than the default — raise the pulse width on that page to 300ms and try again.