Results appear as you type. Use the arrow keys to move and Enter to open. Press the slash key to come back here.

Setting up receipt printing

There are two ways of printing receipts from your till. We recommend printing with the Catinfog agent: the receipt comes straight out of the printer, without the browser’s print dialogue.

Printing with the agent Recommended

The receipt comes straight out of the printer, without the browser’s print dialogue. You only need to install the Catinfog printing agent once: a small, free program that connects the till to your receipt printer. It doesn’t need Java, and there’s nothing to set up in the operating system.

Were you printing with QZ? Raw printing used to rely on a program called QZ. The agent does the job now: it’s faster and causes far fewer problems. You don’t need to uninstall QZ — just follow these steps and the till will switch to printing through the agent.

If you’d rather not install anything, skip to printing from the browser: it’s slower, because it uses the browser’s print dialogue, just like printing any other page.

  1. Plug the receipt printer into the computer and switch it on.
  2. Go to your till’s control panel and open Configuration › Printing.
  3. Under Ticket printing method, pick your paper width: 58 mm, 80 mm · low (for older printers) or 80 mm · high. Paper width cards and the Set up printer button
  4. Click Set up printer. If this computer doesn’t have the agent yet, the till will ask you to install it: follow the steps for your operating system. If it already has it, go straight to choosing the printer.

Installing the agent on Windows

  1. In the till’s window, click Download the agent. The downloads page opens: in the Windows column, download the CatinfogAgenteImpresion-….exe file. Install the printing agent window with the Download the agent button

    Go to the downloads page

  2. Open the downloaded file and follow the installer. Windows will ask for permission to make changes to the computer: click Yes.

    If Windows warns you that the publisher is unknown, or that Windows protected your PC, click More info and then Run anyway. The installer is Catinfog’s; the warning appears because it isn’t digitally signed yet.

  3. Done: the agent is now running and starts by itself every time you switch the computer on. Go back to the till, click I’ve installed it and carry on with choosing the printer.

Installing the agent on a Mac

On a Mac the till doesn’t give you a file, but a command that installs the agent for you.

  1. Open Terminal: press ⌘ + space, type «Terminal» and press Return.
  2. In the till’s window, click Copy next to the command. Paste it into Terminal and press Return. This is the command:

    curl -fsSL https://github.com/remero41/agente-catinfog/releases/latest/download/instalar-macos.sh | bash

    Till window with the command to install the agent on a Mac
  3. macOS will ask for this Mac’s password just once: it lets Safari talk to the agent. Type it in and accept.
  4. Go back to the till, click I’ve installed it and carry on with choosing the printer.

Would you rather use an installer? Download the .pkg file from the downloads page. It isn’t signed yet, so the first time you open it macOS will block it. Go to System Settings › Privacy & Security and click Open Anyway.

Installing the agent on Linux

  1. In the till’s window, click Download the agent. On the downloads page, get the package for your distribution:
    • Ubuntu, Debian or Linux Mint: the .deb file (amd64 on a normal computer; arm64 on a Raspberry Pi).
    • Fedora or openSUSE: the .rpm file.
    • Arch: the .pkg.tar.zst file.

    Go to the downloads page

  2. Install it. You can double-click it to open it in your software manager, or install it from a terminal, in the folder where you downloaded it:

    sudo apt install ./agente-catinfog_*_amd64.deb

    On Fedora or openSUSE, sudo dnf install ./agente-catinfog-*.rpm; on Arch, sudo pacman -U agente-catinfog-*.pkg.tar.zst.
  3. Done: the agent is now running and starts by itself every time you switch the computer on. There’s no need to set up CUPS or unplug the printer. Go back to the till, click I’ve installed it and carry on with choosing the printer.

Choose your printer and print a test

  1. The Choose your printer window lists the printers this computer can see. Click yours: the till prints a test receipt.
  2. If the receipt came out, click Yes, it printed: the printer is now set up. If it didn’t, click It didn’t, try another and pick another one from the list.
  3. Click Save, at the top right. Now you can customise the receipt.

If no printer shows up, check that it’s switched on and properly plugged into the computer, then click Search again.

Printing from the browser

Slower than Raw printing. It prints the receipt through the browser’s own print dialogue, exactly as it would any web page. Nothing to install.

  1. Make a sale and, when the print dialogue appears, choose your receipt printer by clicking Change.

    If your printer isn’t in the list, it isn’t installed on the computer. They usually come with an installation CD, and if you haven’t got it to hand, search for the model on Google: you’ll normally find a manufacturer’s page to download the drivers from.

  2. With the printer selected, click More settings. Set Margins to None, and use Scale to fit the receipt to the width of your paper. Untick Headers and footers as well.
  3. Hit print. If the receipt sits neatly within the width of the paper, you’re set. If it doesn’t reach the right-hand edge, increase the scale; if it runs off the edges, reduce it until it’s right.

How to switch on silent printing

Silent printing means the receipt comes out as soon as you make a sale, with no print dialogue appearing. It’s called that because it stays out of your way.

  1. Open File Explorer and go to Local Disk C › Program Files (x86) — or Program Files if you haven’t got that folder — › Google › Chrome › Application. Right-click the file with the Chrome icon and choose Create shortcut. Accept the message that appears.
  2. Go to the desktop, right-click the shortcut you’ve just created and, in the Target field, go to the end. Press the space bar and type –kiosk-printing. Click OK.
  3. To get into silent printing mode, close any Chrome windows you have open and start Chrome from that desktop shortcut. Make a test sale: the receipt prints straight away, without asking.

If you want to give the shortcut a name — “POS”, say — right-click it, choose Rename and type whatever you prefer.