Skip to Content

Print Master: Direct Local Printing (POS, Invoices, Reports)

by
Odoo
In-App Purchases
v 19.0 Third Party 23
Download for v 19.0 Deploy on Odoo.sh
Availability
Odoo Online
Odoo.sh
On Premise
Odoo Apps Dependencies • Discuss (mail)
• Invoicing (account)
• Point of Sale (point_of_sale)
• Inventory (stock)
Lines of code 1228
Technical Name ll_print_platform
LicenseLGPL-3
Websitehttps://logiclayerhq.com
You bought this module and need support? Click here!
Availability
Odoo Online
Odoo.sh
On Premise
Odoo Apps Dependencies • Discuss (mail)
• Invoicing (account)
• Point of Sale (point_of_sale)
• Inventory (stock)
Lines of code 1228
Technical Name ll_print_platform
LicenseLGPL-3
Websitehttps://logiclayerhq.com
Print Master

Print Master

Direct Local Printing (POS, Invoices, Reports)

by LogicLayer

Odoo 19 Ready

Print POS receipts, invoices, and reports directly to your local or network printer (USB, LAN). Supports ESC/POS and automatic printing with a clean job queue — an IoT Box alternative for on-premise local printing.

Odoo creates print jobs, a lightweight local agent executes them on the workstation that has printer access, and job status/logs stay inside Odoo.

USB Printer Network Printer ESC/POS Automatic Printing IoT Box Alternative
Print Master overview

Why Teams Choose Print Master

Designed for real-world counters and back offices: print reliably where the printer is connected, while keeping job control and logs in Odoo.

USB & Network Printer Support

Print to a USB printer or network printer from the workstation that has printer access — ideal for POS counters, kitchens, and warehouses.

Traceable Jobs

Every print becomes a job with status tracking and logs inside Odoo (pending, assigned, printing, done, failed).

Automatic Printing per Document Type

Use different printers for POS receipts vs invoices/reports, with tenant-aware defaults and explicit per-job selection.

Agent + REST API

Run a production-grade agent (Windows, Linux, macOS) with installers and auto-start — an IoT Box alternative for local printing.

Quick Start

No curl required UI-based setup

Install the module in Odoo, generate a company API key, then install the local agent on the workstation that has access to the printers.

1) In Odoo

  1. Open Printing → Configuration → Printing Setup.
  2. Select your company (Tenant) and click Generate / Load API Key.
  3. Copy the API key (you will paste it into the agent setup UI).
2

Setup the Local Agent

The agent is a lightweight service that bridges Odoo to your local printers. Download the version for your OS:

Copy/paste these URLs (Odoo Apps disables external links):
Latest release: https://github.com/badsha/odoo-print-agent/releases/latest
Repository: https://github.com/badsha/odoo-print-agent
User manual: https://github.com/badsha/odoo-print-agent#readme
If the GitHub release page shows no Assets (no odoo-print-agent.exe), build the agent from source or request the Windows build from the vendor.

Build the Windows Agent (Windows 11)

1) Install Go 1.22+
2) Run:
git clone https://github.com/badsha/odoo-print-agent.git
cd odoo-print-agent
go build -o odoo-print-agent.exe .
odoo-print-agent.exe install
If your preview blocks clicks, copy/paste:
https://github.com/badsha/odoo-print-agent/releases/latest
https://github.com/badsha/odoo-print-agent
  • Windows — use .exe from: https://github.com/badsha/odoo-print-agent/releases/latest
  • macOS — use .zip from: https://github.com/badsha/odoo-print-agent/releases/latest
  • Linux — use .tar.gz from: https://github.com/badsha/odoo-print-agent/releases/latest

Note: On macOS, right-click and select Open if blocked by Gatekeeper.

Install & Configure (Quick Guide)

  1. In Odoo, open Printing → Configuration → Printing Setup and generate your API key.
  2. Download and run the agent installer on the machine that has printer access.
  3. When the installer prints a URL like http://127.0.0.1:PORT/, open it in your browser.
  4. Enter your Odoo URL and paste the API key, select printers, then click Save.
  5. Run/enable the agent service (Windows service / systemd / launchd) so it keeps running.

Agent Config (What You Need)

Required: odoo_url and api_key (generated from Printing Setup).
Optional: define printers in the agent so they auto-sync to Odoo (recommended).
{
  "odoo_url": "https://YOUR-ODOO-URL",
  "api_key": "YOUR_API_KEY",
  "printers": [
    {
      "agent_identifier": "counter_1_receipt",
      "name": "POS Counter 1",
      "printer_type": "receipt",
      "os_printer_name": "EPSON_TM_T20"
    }
  ]
}
Keep agent_identifier stable per physical printer. If it changes, Odoo will treat it as a new printer.

3) Verify

Create a print job from POS or an invoice. Check job status transitions (pending → assigned/printing → done) and verify output at the printer.

If jobs stay pending, the agent is not running or cannot reach Odoo.
If jobs become done but nothing prints, check the printer mapping and OS printer name.

User Manual

From the module README

Copy/paste the App Store link if you need it for documentation or support:

https://apps.odoo.com/apps/modules/19.0/ll_print_platform/

Install

  1. Install Print Master.
  2. Ensure Point of Sale and Invoicing / Accounting are installed.

Initial Setup (Per Company)

  1. Open Printing → Configuration → Printing Setup.
  2. Select the company in Tenant.
  3. Click Generate / Load API Key and copy the key for the agent machine.
Regenerating the API key invalidates the old key immediately.

Run the Local Agent

  • Set odoo_url and api_key in the agent config.
  • Run the agent as a service (Windows service / systemd / launchd) so it stays online.

Register Printers

  • Recommended: define printers in the agent config and let it sync to Odoo.
  • Verify in Odoo: Printing → Configuration → Printers.

Printing Workflows

POS Receipt Printing
  1. Open Point of Sale → Configuration → Point of Sale.
  2. Enable Print Master options and select printers.
  3. Start a session and print a receipt.
Invoice Printing
  1. Open an invoice/bill.
  2. Click Queue Print, select a printer, confirm.
Reports (Any QWeb PDF)
  1. Open Printing → Operations → Direct Print.
  2. Select a report, select a printer, set record IDs, queue the job.
Monitor jobs in Printing → Operations → Jobs.

Troubleshooting

  • 401 Unauthorized: API key is wrong or was regenerated.
  • Jobs stay pending: agent not running, wrong Odoo URL, or agent cannot reach Odoo.
  • Jobs failed: open the job and review the error message and logs.
  • Printers missing: run printer sync again from the agent.

Screenshots

Examples of the setup wizard, printers, and job tracking screens.

Print Master screenshot 1
Print Master screenshot 2
Print Master screenshot 3

Key Features

  • POS integration: automatic printing for receipts, with ESC/POS support.
  • Invoices and reports: queue PDF jobs from invoices and any report action.
  • USB printer and network printer support via a local agent (IoT Box alternative).
  • Printer registry synced from the agent via stable printer identifiers.
  • Job lifecycle with leasing and acknowledgements for safe distributed processing.
  • Job logs in Odoo for auditability and troubleshooting.
  • Multi-company friendly isolation for printers, agents, and jobs.

How It Works

1) Odoo Creates a Job

A POS receipt, invoice, or report is converted into a job payload and queued with a chosen printer.

2) Agent Leases Work

The local agent polls the API using a company API key and leases available jobs for safe processing.

3) Local Printing

The agent prints locally to receipt/kitchen/label/report printers using OS drivers or direct protocols.

4) Status & Logs

Jobs are marked done or failed with an error message and logs are stored in Odoo.

Agent Setup Notes

  • The agent setup UI runs as a local web server and keeps running while you use it; stop it with Ctrl+C after saving the configuration.
  • The agent run loop is what should stay running in production (as a Windows service / systemd unit / launchd job).

Troubleshooting

401 Unauthorized

API key is wrong or was regenerated. Generate a new key in Printing Setup and update the agent configuration.

Jobs Stay Pending

Agent is not running, cannot reach Odoo, or the Odoo URL is not reachable from the agent machine.

Jobs Done, Nothing Prints

Printer mapping is incorrect (OS printer name mismatch), or the printer driver is not installed on the agent workstation.

Duplicate Printers in Odoo

Printers are keyed by agent_identifier. If identifiers change, Odoo will show additional printers. Keep identifiers stable per physical printer.

Supported Printers

Designed to work with printers you already use:

  • Thermal receipt printers (ESC/POS workflows)
  • Kitchen printers
  • Label printers
  • Office printers for PDF reports
  • USB printers and network printers (via local agent)

Contact

Need customization or deployment support?

Company: LogicLayer

Email: hamid.badsha@gmail.com

Phone: +880 1745640055 | WhatsApp

Technical Details

Module: Print Master

Version: 19.0

License: OPL-1

Author: LogicLayer

Please log in to comment on this module

  • The author can leave a single reply to each comment.
  • This section is meant to ask simple questions or leave a rating. Every report of a problem experienced while using the module should be addressed to the author directly (refer to the following point).
  • If you want to start a discussion with the author, please use the developer contact information. They can usually be found in the description.
Please choose a rating from 1 to 5 for this module.