Back to Top

Print Direct: Direct Printing from Desktop & Mobile

Updated 20 March 2026

Troubleshooting Guide:

Introduction

Odoo Print Direct streamlines printing by sending commands directly to printers like Network, ZPL, PDF, WiFi, Bluetooth, and USB devices without downloading files, ensuring fast and efficient output.

Sometimes, users may face problems such as:

  • The printer is not detected
  • The host machine does not appear in Odoo
  • An Android device cannot detect a USB printer

This guide explains the common causes and troubleshooting steps.

1. Unable to Find USB Printer in Android Direct Print App

If the Android Direct Print app cannot detect a USB printer, check the following points.

Enable USB Debugging

  1. Open Settings on the Android device.
  2. Go to Developer Options.
  3. Enable USB Debugging.

If Developer Options are not visible:
1. Open Settings.
2. Go to About Phone.
3. Tap Build Number several times until Developer Mode is enabled.

Searching for an experienced
Odoo Company ?
Find out More

Verify OTG Support

Please make sure of the following:

  • The device supports USB OTG.
  • The OTG adapter is connected properly.
  • The printer is powered ON.
  • After connecting the printer, reopen the Print Direct application and scan again.

2. Cannot Add Printers in Odoo / Host Machine Not Visible

If both the host machine and printers are not visible in Odoo, the issue is usually related to WebSocket or longpolling configuration.

Print Direct application communicates with Odoo using real-time communication channels such as WebSocket.

If this communication is not working properly, Odoo will not detect the host machine or the available printers.

How to Verify WebSocket Connection

Method 1 – Check Using Browser Network Panel
  1. Open Odoo in your browser.
  2. Press F12 to open Developer Tools.
  3. Go to the Network tab.
  4. Filter by WS (WebSocket).

You should see a connection similar to: /websocket
The status should display: 101 Switching Protocols

This means that the WebSocket connection has been successfully established.

Method 2 – Test WebSocket from Browser Console

Open the Console tab in Developer Tools and run the following command:

new WebSocket((location.protocol === ‘https:’ ? ‘wss://’ : ‘ws://’) + location.host + ‘/websocket’)

If WebSocket is working, the connection will open without errors.
If there is a configuration issue, the console may show connection errors.

Solution

Ensure Odoo is started with proxy mode enabled.

Add the following configuration in the Odoo configuration file:
proxy_mode = True
Then start Odoo with a gevent port:
–gevent-port=9000

This enables Odoo to handle WebSocket communication required for direct
printing.

3. Raw Printer Configuration in Windows

In some cases, printers must be configured using a Raw or Generic driver so direct printing can work properly.

Step 1 – Go to Control Panel → Add Printers
https://webkul.chatwhizz.com/share/screenshot/65f80e69cdaeae108327a329

Step 2 – Continue manual setup if no printers are listed
https://webkul.chatwhizz.com/share/screenshot/65f80ec93c2c0210edbb6bd8

Step 3 – Add the printer manually
https://webkul.chatwhizz.com/share/screenshot/65f80f197c85030ffcda7f4a

Step 4 – Select the printer (example shown for Zebra printer)
https://webkul.chatwhizz.com/share/screenshot/65f80f7d7c85030ffcda8023

Step 5 – Select Manufacturer: Generic and Printer: Generic / Text Only
https://webkul.chatwhizz.com/share/screenshot/65f80ff0cdaeae108327a6ec

Step 6 – Provide a name for the printer
https://webkul.chatwhizz.com/share/screenshot/65f810837c85030ffcda8294

4. Ghostscript Error (Windows Users Only)

If you receive an error related to Ghostscript while printing, install the open source Ghostscript application from the official website.

Download from: https://www.ghostscript.com/releases/gsdnld.html

Install the application and restart the Print Direct Desktop Application. See below image for reference.

Ghostscript

5. Use Third Party PDF reader (For Windows)

Some printers might not work with Ghostscript, you can use third-party apps like Foxit Reader or Sumatra PDF that can support your specific printer driver.

Steps:
1. Proceed with downloading and installing the Foxit Reader Application on
your PC.
Visit: https://www.foxit.com/downloads

2. Press (Ctrl + Shift + T), a window will open, specify the path of Foxit
Reader.

3. Open the Print Direct PC(Desktop) Application and enable/use Other Reader for printing PDF(the icon on the Top Right of the Desktop Application should be darkened once enabled).

And all set, next time when you print any PDF file, it will use this third-party application.

6. How to delete cache and Print Direct App data

Your configuration settings are stored on your desktop.

If you face any issue with login or fetching printers. Close the Print Direct application, and navigate to the corresponding folder:-

Windows: C:/Users//AppData/Local/Print Direct For Odoo
Linux: /home/users//.local/share/print-direct-for-odoo

Delete the folder from your computer.
OR
Triple click on the bin icon present on the bottom-right corner of the Print Direct Application.

delete

Now, Restart the application.

Current Product Version - 1.0.0

Supported Framework Version - Odoo v12, v13, v14, v15, v16, v17, v18, v19

. . .

Leave a Comment

Your email address will not be published. Required fields are marked*


Be the first to comment.

Back to Top

Message Sent!

If you have more details or questions, you can reply to the received confirmation email.

Back to Home

Print Direct: Direct Printing from Desktop & Mobile