OpenLabel 0.1.0

<div align="center">

OpenLabel

ZPL Labeling with Open-Source Flexibility

<img alt="OpenLabel logo" height="280" src="/assets/openlabel.png" />

</div>

Project Description

OpenLabel is a C# library designed to streamline working with Zebra Programming Language (ZPL) for label printing. It enables developers to send ZPL commands to Zebra label printers, scale labels for different printer resolutions, and customize labels using a flexible templating system.</br></br> This library is particularly useful for scenarios where ZPL labels are generated using external tools like Labelary or other ZPL design software. With OpenLabel, developers can dynamically modify these labels by replacing placeholders, handling conditional statements, and ensuring compatibility across different printer resolutions.</br></br> Whether you need to automate label printing, generate dynamic ZPL templates, or adjust labels for varying printer resolutions, OpenLabel provides the flexibility and simplicity required for efficient label management.

Table of Contents

• OpenLabel - ZPL Labeling with Open-Source Flexibility
• Project Description
  • Features
  • Installation
  • Usage
    • 1. Print a Label
    • 2. Scale a Label
    • 3. Use Templates
• License

Features

• Print ZPL Labels: Easily send ZPL commands to a Zebra printer over the network.
• Scale Labels: Adjust ZPL code to fit different printer resolutions (DPI).
• Template System: Replace placeholders with actual values and handle conditional statements inside ZPL templates.

Installation

Add this library to your project via NuGet or by including the source code.

Usage

1. Print a Label

NetworkPrinter printer = new NetworkPrinter();
await printer.PrintLabelAsync(@"\\server\printer", 5, "^XA^FO50,50^A0N,50,50^FDHello, World!^FS^XZ");

2. Scale a Label

string scaledZPL = LabelScaler.ScaleZPL("^XA^FO50,50^FS^XZ", 203, 300);

3. Use Templates

TemplateHandler templateHandler = new TemplateHandler();
string template = "{{IF CONDITION}}^FO50,50^FDText^FS{{ENDIF}}";
Dictionary<string, string> placeholders = new Dictionary<string, string> { { "CONDITION", "1" } };
string renderedLabel = templateHandler.RenderTemplate(template, placeholders);

License

This software is licensed under the GPL-3.0 license

Acknowledgements

• The code for the ZPL scaling was in large part possible with the work of:
  • isatufan
  • deexno