@luckykiet/node-printer

Native printer bindings for Node.js on POSIX and Windows. Fork of @thiagoelg/node-printer with Node 24+ support.

What's different from the original?

• Node 24/25 support — C++20 build, updated V8 compatibility
• VS2026 compatibility — fixed C++ two-phase name lookup for MSVC 18+
• No Python dependency — build uses Node.js instead of Python for source file discovery
• Updated native dependencies (nan 2.25+, node-abi 4.26+)
• macOS arm64 (Apple Silicon) prebuild support
• Modernized GitHub Actions (v4, Node 24)
• Minimum Node version: 20.0.0

Install

npm install @luckykiet/node-printer

Build prerequisites

The native addon compiles from source if no prebuild is available.

macOS: Xcode Command Line Tools (ships with CUPS)

xcode-select --install

Linux (Debian/Ubuntu):

sudo apt-get install libcups2-dev

Windows: Visual Studio Build Tools with C++ workload

API

const printer = require('@luckykiet/node-printer');

| Method | Description | |--------|-------------| | getPrinters() | List all installed printers with jobs and statuses | | getPrinter(name) | Get specific printer info | | getDefaultPrinterName() | Get default printer name | | getPrinterDriverOptions(name) | Get driver options (POSIX only) | | getSelectedPaperSize(name) | Get default paper size (POSIX only) | | printDirect(options) | Send raw data to printer | | printFile(options) | Print a file (POSIX only) | | getSupportedPrintFormats() | List supported formats (RAW, TEXT, PDF, etc.) | | getJob(printerName, jobId) | Get job info | | setJob(printerName, jobId, command) | Send command to job (e.g. CANCEL) | | getSupportedJobCommands() | List supported job commands |

Examples

const printer = require('@luckykiet/node-printer');

// List printers
console.log(printer.getPrinters());

// Print raw text
printer.printDirect({
  data: 'Hello from Node.js!',
  printer: printer.getDefaultPrinterName(),
  type: 'TEXT',
  success: (jobId) => console.log('Job ID:', jobId),
  error: (err) => console.error(err),
});

See the examples directory for more usage patterns.

Credits

• Ion Lupascu — original author (tojocky/node-printer)
• Thiago Lugli (@thiagoelg) — Node 12+ support & prebuild CI
• Eko Eryanto (@ekoeryanto) — prebuild integration

License

MIT