printmelo Log in Try for free

How Printmelo works

Everything you need to print from your software, and to find out yourself what is going on when nothing comes out of the printer.

Last updated on

How it works

Printmelo has three parts that work together.

The dashboard
At app.printmelo.com you see your computers, printers and print jobs. This is where you pair computers and set up printers.
The client
A small program on the computer your printers are connected to. It registers the printers and prints what comes in. It runs in the background and starts with the computer.
The API
Your online store or warehouse software uses it to send a document to a printer. You can also print without the API by uploading a file in the dashboard.

A print job goes like this: your software sends a document to Printmelo, the client on the right computer gets a signal straight away, fetches the document and hands it to the printer.

Get started

  1. Create an account

    Go to app.printmelo.com/register. You start with a 14-day trial.

  2. Install the client

    Download the client on the computer next to your printer, from the download page or from the dashboard. There is nothing to set up. Does Windows show a warning? Click More info and then Run anyway.

  3. Pair the computer

    Click Pair computer in the dashboard and create a pairing code. Enter that code in the client. The code is valid for 15 minutes and works once. You do not need a password on the computer next to the printer.

  4. Print a test page

    The printers of the computer are now in the overview. Click Test print next to a printer. If the page comes out of the printer, everything is paired correctly.

Do you have more computers? Repeat steps 2 to 4 for each computer. Each computer gets its own pairing code.

Printing

From your software

Create a key under API keys in the dashboard and give it to your software or your developer. The id of each printer is in the overview. See For developers.

Upload a file

Click Print file in the dashboard, choose the printer and the file, and click Print. Useful for printing something separately or for testing whether a document comes out of the printer correctly.

Which files can I print?

  • PDF, for packing slips, invoices and shipping labels.
  • Images in PNG or JPEG. You need client 0.2.0 or newer for this.
  • Printer language such as ZPL, for label printers. It goes to the printer unchanged.

A document can be up to 20 MB.

Where is my data stored?

On servers in Amsterdam, within the EU. A document disappears from our server as soon as the print job is done, unless you choose to keep it.

Can I reprint a print job?

Yes, if you keep documents. By default we delete a document right after printing. Under Account you choose to keep documents for 1, 4, 24 or 72 hours. During that time the print job shows the Reprint button. After that we remove the document automatically.

The computer is switched off. What happens to my print job?

The print job waits and prints as soon as the computer is connected again. If that takes too long, it expires. You see that on the print job.

Printer settings

Click Settings next to a printer in the overview. What you choose here applies to every PDF sent to that printer.

Name
Give the printer a recognisable name, such as "Label printer packing station 1".
Paper size
Choose the size of your labels or paper, for example a shipping label of 100 × 150 mm. If your label comes out half printed or spread over several sheets, this setting is usually wrong.
Double-sided and fit to paper
Choose whether the printer prints double-sided and whether the document is fitted to the paper size.
Paper tray and colour
Choose which tray the printer takes paper from and whether it prints in colour or black and white.
Fallback printer
Choose a second printer that takes over when this printer is offline or the computer is switched off. That way you keep printing during a fault.

Printer groups

Do you have several printers that do the same work? Create a group under Printer groups with the printers in order of preference. Your software sends the print job to the group, and Printmelo chooses the first printer that is available.

You do not have to set anything up on the computer next to the printer. Printer language such as ZPL always goes to the printer unchanged: these settings do not apply to it.

Sharing printers

Which printers are in the dashboard?

In the client you tick for each printer whether you want to use it through Printmelo. Only those printers are in the dashboard. With Make new printers available automatically you decide what happens to a printer you add later. You need client 0.3.0 or newer for this.

A printer on the network without a computer next to it

Click Add network printer in the client and enter a name, the IP address and the port. The usual port is 9100. The computer with the client must be able to reach the printer on the network. A printer like this only prints printer language such as ZPL. For a PDF you install the printer on the computer itself.

Users and statistics

Under Users the owner invites colleagues. You get a link that you forward yourself. Your colleague chooses their own password. The link works for seven days and once.

Member
Views computers, printers, print jobs and statistics. Prints a file or a test page, or reprints a print job.
Manager
Pairs computers and manages printers, printer groups, API keys and webhooks.
Owner
Also manages the subscription and the users.

Under Statistics you see the number of print jobs per day, per printer and per computer, how many failed and how long printing took on average.

Statuses of a print job

Click a print job in the dashboard. You see a timeline with every step and how long it took.

StatusMeaning
NewPrintmelo has received the print job.
SentThe computer has received a signal.
In progressThe client has picked up the print job.
In printer queueThe document is ready on the computer and waits for the printer. If the printer is waiting for something, the reason is shown.
PrintedThe printer has reported that the document is printed.
FailedSomething went wrong. The message and what you can do are on the print job.
ExpiredThe computer did not pick up the print job in time.
CancelledYou or your software cancelled the print job.

Troubleshooting

Always start with the print job itself. It shows what happened and what you can do.

Windows warns when installing the client

Windows does not know the installer yet and shows the blue window "Windows protected your PC". Click More info and then Run anyway. Only download the client from printmelo.com or the dashboard.

Do you not see the button, or does your virus scanner block the installer? Then your computer is managed by your IT department. Ask your administrator to allow the installer.

Nothing comes out of the printer

Open the print job in the dashboard and look at the status.

  • Sent and the computer is disconnected: switch on the computer and start the client. The print job then prints automatically.
  • In printer queue: the printer is waiting for something. The reason is shown, for example out of paper, paused or offline.
  • Printed, but there is nothing in the tray: look at the printer queue on the computer and check that it is the right printer.
The computer shows "Disconnected"

The client is not running or the computer has no internet. Check that the computer is switched on and look for the Printmelo icon: bottom right on Windows, top right on a Mac. If you do not see it, start the client again.

The client has a checkbox Start when the computer starts. Leave it on.

My label comes out half printed or spread over several sheets

Choose the paper size of your labels in the printer settings. With a label printer that does not recognise the size, it helps to calibrate the printer again. See the manual of the printer for that.

The print job shows "Failed"

Open the print job. At the top you see the message from the printer or the computer, with advice. If a test print from the dashboard does work, the cause is the document and not the printer.

My printer is not in the overview

The client reports every printer installed on the computer. If a printer is missing, add it in the printer settings of the computer itself. It appears within a minute.

My pairing code does not work

A code is valid for 15 minutes and works once. Create a new code in the dashboard. If you get a message about your subscription, you have reached the number of computers in your subscription.

I want to know what is going on with a computer

Click Diagnostics next to the computer in the overview and then Request new diagnostics. You see the connection, the printers with their messages and what the client has done recently. You do not have to walk over to the computer.

Printing takes a few seconds longer than normal

Does the client say "Connected, slower"? Then the fast connection is not active and the client fetches print jobs itself every ten seconds. Often a firewall or proxy in your network blocks this connection.

Connect an AI assistant

Printmelo has an MCP server. It lets an AI assistant such as Claude or ChatGPT look into your account. You ask your question in plain language and the assistant finds the answer.

The address of the MCP server is https://api.printmelo.com/mcp.

What can the assistant do?

  • Show your printers, with their status and whether they can print right now.
  • Search print jobs and explain why a print job did not print.
  • Request a diagnosis of a computer.
  • Show your usage: print jobs this month and the daily budget of the connection.
  • Send a test page, reprint a print job or print a document. Only if you turn on printing.

The assistant does not manage your subscription, payments, users or API keys. It cannot delete anything either.

Connect Claude or ChatGPT

  1. Add a connector in your assistant with the address https://api.printmelo.com/mcp.
  2. Log in with your Printmelo account.
  3. Choose what the assistant may do. Read is always on. You turn on Print yourself, with a daily budget.
  4. Click Allow. You return to your assistant and can ask your first question.

Connect a coding agent

You connect Claude Code, Cursor and other coding agents with an API key. In the dashboard under Integrations, create a key with the Read permission, and with Print if the agent may print too. Give the agent the address of the MCP server and the key as a Bearer token. The agent then searches the API documentation and tests on the practice printer, without using paper.

How does printing stay safe?

An assistant that may print has a daily budget. The default is 50 print jobs per day. After that it stops until the next day. One request prints at most 5 copies. A print job that the computer does not pick up within an hour expires. The log of your print jobs shows which connection printed what.

Disconnect

In the dashboard, go to Integrations and then to AI assistant. Click Disconnect next to the connection. The assistant can no longer reach your account from that moment.

Subscription

You start with a 14-day trial. After that you move to the free plan automatically: 1 computer and 100 print jobs per month. Under Subscription in the dashboard you see your usage and choose a larger plan, per month or per year. The prices are on the pricing page.

On the free plan printing stops at the limit, until the new month starts. Your software then gets a clear message. With a paid plan you keep printing above your limit. We charge the overage the month after.

A more expensive plan starts right away. A cheaper plan and cancelling take effect at the end of your term.

For developers

The full API is described in the API documentation, with all endpoints, examples and error codes.

This is how you send a PDF to a printer:

curl -X POST https://api.printmelo.com/api/v1/printjobs \
  -H "Authorization: Bearer $API_KEY" \
  -H "Content-Type: application/json" \
  -H "Idempotency-Key: order-1001-label" \
  -d '{"printer_id": 1, "title": "Shipping label 1001",
       "content_type": "pdf_uri",
       "content": "https://example.com/label.pdf"}'

For content_type you choose pdf_uri, pdf_base64, image_uri, image_base64, raw_uri or raw_base64. The OpenAPI description is at app.printmelo.com/openapi.json.

  • Send a print job: one call with the id of the printer and the document.
  • Webhooks: your software hears right away whether a print job is printed or failed.
  • Switching from PrintNode: PrintNode field names also work with us. Read how to switch.