Windows Thermal Printer Driver (V4)

A Windows V4 printer driver that converts XPS/GDI print output into thermal printer command languages (Zebra ZPL and TSC TSPL). Designed for direct-thermal and thermal-transfer label printers commonly used in shipping, warehousing, and retail environments.

Supported Hardware

• Zebra GK420d, GX430t, ZD620, ZT410 series (ZPL mode)
• TSC TTP-247, TE210, DA220 series (TSPL mode)
• Any ZPL II or TSPL-compatible thermal printer

Architecture

This driver uses the Windows V4 print driver model:

1. ThermalPrinter.inf - Driver installation and configuration
2. ThermalPrinter.gpd - Generic Printer Description for print capabilities
3. src/RenderFilter.cpp - XPS render filter that converts spool data to ZPL/TSPL

The render filter operates in the print pipeline, receiving XPS documents from the spooler and emitting raw printer commands over USB or TCP/IP.

Building

Requires Windows Driver Kit (WDK) 10.0.22621.0 or later.

build.cmd

The build script invokes MSBuild with the WDK toolset to compile the render filter DLL and package the driver.

Label Configuration

Default label size is 4" x 6" (shipping label). Supported sizes include:

• 4" x 6" (101.6mm x 152.4mm)
• 4" x 3" (101.6mm x 76.2mm)
• 2" x 1" (50.8mm x 25.4mm)

DPI settings: 203 DPI (default), 300 DPI, 600 DPI.

License

This project is licensed under the MIT License. See LICENSE.