Install ZPL2PDF using Winget - wingetCollections

ZPL2PDF Bruno Campos

cli cli-tool command-line converter cross-platform daemon dotnet label labelary pdf printing zebra zpl

Use this command to install ZPL2PDF:

winget install --id=brunoleocam.ZPL2PDF -e

ZPL2PDF is a command-line tool designed to convert Zebra Programming Language (ZPL) labels into PDF files offline. This utility reads ZPL/ZPL II code, renders it in memory, and generates a multi-page PDF where each page represents a label. Built on BinaryKits.Zpl, ZPL2PDF is optimized for automated workflows, bulk processing, and integration with enterprise systems.

Key Features:

Accurate ZPL Rendering: Converts ZPL labels to high-quality images without temporary files.
Batch Conversion: Generates multi-page PDFs from multiple labels in a single file.
Windows CLI: Supports command-line operations for scripting and automation.
Customizable Output: Adjust label dimensions, density, and units (inches, centimeters, millimeters) to match specific requirements.

Audience & Benefit:

Ideal for developers, IT professionals, and warehouse teams requiring offline ZPL-to-PDF conversion. This tool streamlines label processing for automated print pipelines, ERP systems, and bulk operations, saving time and reducing manual steps in workflows.

Install via winget or download the executable from the official repository to integrate ZPL2PDF into your workflow efficiently.

README

ZPL2PDF - ZPL to PDF Converter

GitHub all releases

A powerful, cross-platform command-line tool that converts ZPL (Zebra Programming Language) files to high-quality PDF documents. Perfect for label printing workflows, automated document generation, and enterprise label management systems.

ZPL2PDF Demo

🚀 What's New in v3.1.1

🔧 Changed

Release tooling: Scripts under release/scripts/; Linux packaging assets under scripts/release/packages/ (documentation and contributor paths updated).
Internals: Single Labelary PDF fallback path in across CLI, API, TCP server, and daemon; dimension/value-object consolidation and daemon PID handling without reflection.

Versions

3.1.1

3.1.0

3.0.3

3.0.2

3.0.0

2.0.1

2.0.0

1.0.0

Website

github.com

License

Last updated

3/24/2026

Download latest version

ConversionService

ZPL2PDF -i label.txt -o output/ -n mylabel.pdf

ZPL2PDF start -l "C:\Labels"

ZPL2PDF server start --port 9101 -o output/

# Temporary (current session)
ZPL2PDF status --language pt-BR

# Permanent (all sessions)
ZPL2PDF --set-language pt-BR

# Check configuration
ZPL2PDF --show-language

winget install brunoleocam.ZPL2PDF

# Download .deb package from releases
wget https://github.com/brunoleocam/ZPL2PDF/releases/download/v3.1.1/ZPL2PDF-v3.1.1-linux-amd64.deb

# Install package
sudo dpkg -i ZPL2PDF-v3.1.1-linux-amd64.deb

# Fix dependencies if needed
sudo apt-get install -f

# Verify installation
zpl2pdf -help

# Download tarball from releases
wget https://github.com/brunoleocam/ZPL2PDF/releases/download/v3.1.1/ZPL2PDF-v3.1.1-linux-x64-rpm.tar.gz

# Extract to system
sudo tar -xzf ZPL2PDF-v3.1.1-linux-x64-rpm.tar.gz -C /

# Make executable
sudo chmod +x /usr/bin/ZPL2PDF

# Create symbolic link
sudo ln -s /usr/bin/ZPL2PDF /usr/bin/zpl2pdf

# Verify installation
zpl2pdf -help

docker pull brunoleocam/zpl2pdf:latest
docker run -v ./watch:/app/watch -v ./output:/app/output brunoleocam/zpl2pdf:latest

# Download
curl -L https://github.com/brunoleocam/ZPL2PDF/releases/download/v3.1.1/ZPL2PDF-v3.1.1-osx-x64.tar.gz -o zpl2pdf.tar.gz

# Extract and run
tar -xzf zpl2pdf.tar.gz
./ZPL2PDF -help

curl -L https://github.com/brunoleocam/ZPL2PDF/releases/download/v3.1.1/ZPL2PDF-v3.1.1-osx-arm64.tar.gz -o zpl2pdf.tar.gz
tar -xzf zpl2pdf.tar.gz
./ZPL2PDF -help

ZPL2PDF -i label.txt -o output_folder -n my_label.pdf

ZPL2PDF -i label.txt -o output_folder -w 10 -h 5 -u cm

ZPL2PDF -z "^XA^FO50,50^A0N,50,50^FDHello World^FS^XZ" -o output_folder

# Start with default settings
ZPL2PDF start

# Start with custom folder
ZPL2PDF start -l "C:\Labels" -w 7.5 -h 15 -u in

# Check status
ZPL2PDF status

# Stop daemon
ZPL2PDF stop

ZPL2PDF -i  (-o  | --stdout) [options]
ZPL2PDF -z  (-o  | --stdout) [options]

Parameter	Description	Example
`-i`	Input ZPL file (.txt, .prn, .zpl, .imp)	`-i label.zpl`
`-z`	ZPL content as string	`-z "^XA...^XZ"`
`-o`	Output folder for PDF (required unless `--stdout`)	`-o C:\Output`
`--stdout`	Write PDF bytes to stdout only (no file)	`--stdout`
`-n`	Output PDF filename (optional; default: input basename or timestamp for `-z`)	`-n result.pdf`
`-w`	Label width	`-w 10`
`-h`	Label height	`-h 5`
`-u`	Unit (mm, cm, in)	`-u cm`
`-d`	Print density (default: 203)	`-d 300`
`--renderer`	Rendering engine (offline/labelary/auto)	`--renderer labelary`
`--fonts-dir`	Custom fonts directory	`--fonts-dir C:\Fonts`
`--font`	Map specific font	`--font "A=arial.ttf"`

ZPL2PDF -i zpl_teste.txt -o output -n label1.pdf -d 600 -w 10.0 -h 8.0 -u cm --fonts-dir ./fonts --font "A=arial.ttf" --font "B=another.ttf"

ZPL2PDF start [options]    # Start daemon in background
ZPL2PDF stop               # Stop daemon
ZPL2PDF status             # Check daemon status
ZPL2PDF run [options]      # Run daemon in foreground (testing)

Option	Description	Default
`-l`	Folder to monitor	`Documents/ZPL2PDF Auto Converter`
`-w`	Fixed width for all conversions	Extract from ZPL
`-h`	Fixed height for all conversions	Extract from ZPL
`-u`	Unit of measurement	`mm`
`-d`	Print density	`203`

ZPL2PDF server start [options]    # Start TCP server (virtual printer)
ZPL2PDF server stop               # Stop TCP server
ZPL2PDF server status             # Check TCP server status

--language            # Temporary language override
--set-language        # Set language permanently
--reset-language            # Reset to system default
--show-language             # Show current configuration

ZPL2PDF -i label.txt -o output/ --renderer offline

ZPL2PDF -i label.txt -o output/ --renderer labelary

ZPL2PDF -i label.txt -o output/ --renderer auto

ZPL2PDF --api --host localhost --port 5000

curl -s http://localhost:5000/api/health

{
  "status": "ok",
  "service": "ZPL2PDF API"
}

{
  "zpl": "^XA...^XZ",
  "zplArray": ["^XA...^XZ"],
  "format": "pdf",
  "width": 7.5,
  "height": 15,
  "unit": "in",
  "dpi": 203,
  "renderer": "offline"
}

curl -s -X POST http://localhost:5000/api/convert -H "Content-Type: application/json" -d '{
  "zpl": "^XA^FO50,50^A0N,50,50^FDHello^FS^XZ",
  "format": "pdf",
  "renderer": "offline",
  "width": 7.5,
  "height": 3,
  "unit": "in",
  "dpi": 203
}'

{
  "success": true,
  "format": "pdf",
  "pdf": "JVBERi0xLjQKJc...base64...",
  "pages": 1,
  "message": "Conversion successful"
}

curl -s -X POST http://localhost:5000/api/convert -H "Content-Type: application/json" -d '{
  "zpl": "^XA^FO50,50^A0N,50,50^FDHello^FS^XZ",
  "format": "pdf",
  "renderer": "labelary",
  "width": 7.5,
  "height": 3,
  "unit": "in",
  "dpi": 203
}'

{
  "success": true,
  "format": "pdf",
  "pdf": "JVBERi0xLjQKJc...base64...",
  "pages": 1,
  "message": "Conversion successful"
}

curl -s -X POST http://localhost:5000/api/convert -H "Content-Type: application/json" -d '{
  "zpl": "^XA^FO50,50^A0N,50,50^FDHello^FS^XZ",
  "format": "png",
  "renderer": "labelary",
  "width": 7.5,
  "height": 3,
  "unit": "in",
  "dpi": 203
}'

{
  "success": true,
  "format": "png",
  "image": "iVBORw0KGgo...base64...",
  "pages": 1,
  "message": "Conversion successful"
}

# Pull image
docker pull brunoleocam/zpl2pdf:latest

# Run daemon mode
docker run -d \
  --name zpl2pdf \
  -v ./watch:/app/watch \
  -v ./output:/app/output \
  -e ZPL2PDF_LANGUAGE=en-US \
  brunoleocam/zpl2pdf:latest

version: '3.8'

services:
  zpl2pdf:
    image: brunoleocam/zpl2pdf:latest
    container_name: zpl2pdf-daemon
    volumes:
      - ./watch:/app/watch
      - ./output:/app/output
    environment:
      - ZPL2PDF_LANGUAGE=pt-BR
    restart: unless-stopped

docker-compose up -d

{
  "language": "en-US",
  "defaultListenFolder": "C:\\Users\\user\\Documents\\ZPL2PDF Auto Converter",
  "labelWidth": 10,
  "labelHeight": 5,
  "unit": "cm",
  "dpi": 203,
  "logLevel": "Info",
  "retryDelay": 2000,
  "maxRetries": 3
}

^XA
^PW800        ← Width: 800 points
^LL1200       ← Height: 1200 points
^FO50,50^A0N,50,50^FDHello^FS
^XZ

src/
├── Application/          # Use Cases &amp; Services
│   ├── Services/         # Business logic
│   └── Interfaces/       # Service contracts
├── Domain/              # Business entities &amp; rules
│   ├── ValueObjects/    # Value objects
│   └── Services/        # Domain interfaces
├── Infrastructure/      # External concerns
│   ├── FileSystem/      # File operations
│   ├── Rendering/       # PDF generation
│   └── Processing/      # Queue management
├── Presentation/        # CLI &amp; user interface
│   └── Handlers/        # Mode handlers
└── Shared/             # Common utilities
    ├── Localization/   # Multi-language
    └── Constants/      # Configuration

# All tests
dotnet test

# Unit tests only
dotnet test tests/ZPL2PDF.Unit/

# Integration tests
dotnet test tests/ZPL2PDF.Integration/

# With coverage
dotnet test --collect:"XPlat Code Coverage"

// C# example
Process.Start("ZPL2PDF.exe", "-i label.txt -o output/ -w 10 -h 5 -u cm");

# Process all ZPL files in a folder
for file in *.txt; do
    ZPL2PDF -i "$file" -o output/
done

# Start daemon on system startup
ZPL2PDF start -l "C:\Labels\Incoming"

# Deploy to server
docker run -d \
  -v /srv/labels:/app/watch \
  -v /srv/pdfs:/app/output \
  --restart always \
  brunoleocam/zpl2pdf:latest

# Clone repository
git clone https://github.com/brunoleocam/ZPL2PDF.git
cd ZPL2PDF

# Restore dependencies
dotnet restore

# Build solution
dotnet build

# Run tests
dotnet test

# Build for your platform
dotnet publish -c Release -r win-x64 --self-contained true

# Build all platforms
.\scripts\build-all-platforms.ps1  # Windows
./scripts/build-all-platforms.sh   # Linux/macOS

ZPL2PDF/
├── src/                    # Source code (Clean Architecture)
├── tests/                  # Unit &amp; integration tests
├── docs/                   # Documentation
│   ├── i18n/              # Translated documentation
│   ├── Image/             # Screenshots &amp; icons
│   └── Sample/            # Sample ZPL files
├── installer/              # Windows installer (Inno Setup)
├── scripts/                # Build &amp; release scripts
├── .github/workflows/      # GitHub Actions CI/CD
├── docker-compose.yml      # Docker orchestration
└── Dockerfile              # Docker image definition

Issue	Solution
File Locked Error	Wait for the process writing the file to complete
Invalid ZPL Content	Ensure file contains valid ZPL commands (`^XA...^XZ`)
Permission Denied	Run with appropriate permissions or check folder access
Docker: libgdiplus not found	Use official image: `brunoleocam/zpl2pdf:alpine`

# Enable verbose logging by setting "logLevel": "Debug" in `zpl2pdf.json`
# (then re-run your command)
ZPL2PDF -i label.txt -o output/

# 1. Fork and clone
git clone https://github.com/YOUR_USERNAME/ZPL2PDF.git

# 2. Create feature branch
git checkout -b feature/amazing-feature

# 3. Make changes and test
dotnet test

# 4. Commit and push
git commit -m "feat: add amazing feature"
git push origin feature/amazing-feature

# 5. Create Pull Request

Option	Description	Default
`--port`	TCP port to listen on	`9101`
`-o`	Output folder for PDFs	`Documents/ZPL2PDF TCP Output`
`--foreground`	Run in foreground (not background)	Background
`--renderer`	Rendering engine	`offline`

Metric	Value
Single Label	~50ms
Batch Processing	100+ labels/minute
Memory Usage	<50MB typical
PDF File Size	~100KB per label
Startup Time	<1 second

ZPL2PDF Bruno Campos

README

ZPL2PDF - ZPL to PDF Converter

🚀 What's New in v3.1.1

🔧 Changed

🛠️ Maintenance

Recent highlights (v3.1.1)

✨ Key Features

🎯 Three Operation Modes

Conversion Mode - Convert individual files

Daemon Mode - Auto-monitor folders

TCP Server Mode - Virtual printer

📐 Intelligent Dimension Handling

🌍 Multi-Language Interface

📦 Installation

Windows

Option 1: WinGet (Recommended)

Option 2: Installer

Linux

Ubuntu/Debian (.deb package)

Fedora/CentOS/RHEL (.tar.gz)

Docker (All Linux distributions)

macOS

Intel Macs

Apple Silicon (M1/M2/M3)

🚀 Quick Start

Convert a Single File

Convert with Custom Dimensions

Convert ZPL String Directly

Start Daemon Mode (Auto-Conversion)

📖 Usage Guide

Conversion Mode Parameters

Daemon Mode Commands

TCP Server Commands

Language Commands

🎨 Rendering Engines

Offline (BinaryKits) - Default

Labelary (API) - High Fidelity

Auto (Fallback)

🌐 REST API

Health check

Convert (ZPL to PDF/PNG)

Request body

Example: PDF (offline renderer)

Example: PDF (Labelary renderer - direct PDF)

Example: PNG (Labelary renderer)

🐳 Docker Usage

Quick Start with Docker

Docker Compose

🔧 Configuration

Configuration File (zpl2pdf.json)

Environment Variables

📐 ZPL Support

Supported ZPL Commands

Dimension Extraction

Priority Logic

🏗️ Architecture

🧪 Testing

Run Tests

Test Coverage

📚 Documentation

User Guides

Developer Guides

Build & Deployment

💡 Use Cases

1. ERP Integration

2. Batch Processing

3. Automated Workflow

4. Docker Deployment

📊 Performance

Benchmarks

Optimization Features

🛠️ Development

Prerequisites

Build from Source

Project Structure

🐛 Troubleshooting

Common Issues

Debug Mode

Get Help

Configuration File (`zpl2pdf.json`)