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 powerful, cross-platform command-line tool that converts ZPL (Zebra Programming Language) files to high-quality PDF documents. Key Features: • Dual Operation Modes - Conversion mode for individual files and daemon mode for automatic folder monitoring • Multi-language Support - 8 languages (EN, PT, ES, FR, DE, IT, JA, ZH) • Intelligent Dimension Handling - Automatic extraction from ZPL commands (^PW, ^LL) • Cross-Platform - Native support for Windows, Linux, and macOS • Clean Architecture - Built with SOLID principles and 90%+ test coverage • High Performance - Async processing with retry mechanisms • Docker Support - Optimized Alpine Linux image (470MB) Perfect for: • Label printing workflows • Automated document generation • Enterprise label management systems • ERP integration • Batch processing

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 v2.0

🌍 Multi-language Support - 8 languages (EN, PT, ES, FR, DE, IT, JA, ZH)
🔄 Daemon Mode - Automatic folder monitoring and batch conversion
🏗️ Clean Architecture - Completely refactored with SOLID principles

Versions

2.0.0

1.0.0

Website

github.com

License

Last Updated

10/8/2025

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

ZPL2PDF start -l "C:\Labels"

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

# 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/v2.0.0/ZPL2PDF-v2.0.0-linux-amd64.deb

# Install package
sudo dpkg -i ZPL2PDF-v2.0.0-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/v2.0.0/ZPL2PDF-v2.0.0-linux-x64-rpm.tar.gz

# Extract to system
sudo tar -xzf ZPL2PDF-v2.0.0-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/v2.0.0/ZPL2PDF-v2.0.0-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/v2.0.0/ZPL2PDF-v2.0.0-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  [options]
ZPL2PDF -z  -o  [options]

Parameter	Description	Example
`-i`	Input ZPL file (.txt or .prn)	`-i label.txt`
`-z`	ZPL content as string	`-z "^XA...^XZ"`
`-o`	Output folder for PDF	`-o C:\Output`
`-n`	Output PDF filename (optional)	`-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`

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`

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

# 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",
  "defaultWatchFolder": "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/    # Immutable data 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
ZPL2PDF -i label.txt -o output/ --log-level Debug

# 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

Variable	Description	Example
`ZPL2PDF_LANGUAGE`	Application language	`pt-BR`
`ZPL2PDF_LOG_LEVEL`	Logging level	`Debug`

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 v2.0

✨ Key Features

🎯 Dual Operation Modes

Conversion Mode - Convert individual files

Daemon Mode - Auto-monitor folders

📐 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

Language Commands

🐳 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

🤝 Contributing

Quick Start

📄 License

🙏 Acknowledgments

📞 Support

🌟 Star History

👥 Contributors

Configuration File (`zpl2pdf.json`)