PEX - Printer Execution Service

Printer execution JavaScript client library.

PEX is a lightweight Python-based printer service and server. It allows direct print jobs to local printers without triggering the usual print dialog. This is especially useful for web apps, PWAs, or kiosk systems where seamless printing is mandatory.

This JavaScript library provides a minimal, typed client for the PEX HTTP API.

Installation

npm i @pytes.net/pex-client

Usage

import { PEX } from "@pytes.net/pex-client";

// Create and configure your new PEX client.
// All options shown below reflect the default values.
const pex = new PEX({
    host: "127.0.0.1",
    port: 4422,
    protocol: "http",
    timeout: 10_000,
    headers: {
        Accept: "application/json",
    },
    exceptions: true,
});

// Retrieve status
await pex.status();

// Retrieve installed printers
await pex.printers();

// Print / Send a file using a FormData object
const data = new FormData;
data.set("file", new File([blobData], "document.pdf", { type: "application/pdf" }));
data.set("printer", "Canon TS8300 series");
data.set("format", "A4");
data.set("orientation", "P");
data.set("quantity", 1);
await pex.print(data);

// Print / Send some lines using a JSON payload
await pex.print({ 
    lines: ["foo", "bar"],
    printer: "Zebra ZD411 Label Printer",
    font_name: "Arial",
    font_size: 12,
    line_height: 14,
});

| Method | Description | | ----------------- | -------------------------------------------------- | | pex.status() | Returns service and printer configuration details | | pex.printers() | Lists all available printers | | pex.print(data) | Sends a print job (FormData or Payload object) |

License

Published under the MIT License
Copyright © 2024 - 2026 pytesNET [email protected]