V 2.0.0

ZPL Print Universal Driver (Windows)

ZPLPrintDriver.exe is a versatile command-line tool for sending ZPL (Zebra Programming Language) code to network-connected and USB-connected Zebra printers. It is designed for easy integration into various programming environments that support console command execution.

Features

• Send ZPL code directly from a file to a Zebra printer over the network.
• Supports specifying the printer's IP address and port.
• Allows printing multiple copies of the label.
• Configurable timeout for network operations.
• Cross-language compatibility through easy-to-use command-line execution.

Usage

You can run the program directly from the command line by providing the necessary arguments.

Command Line Arguments

Print Over Network

• --path (required): Full path to the ZPL file you want to send to the printer.
• --printer (required): The IP address of the Zebra printer.
• --port (optional): Printer port number. Default is 9100.
• --copies (optional): Number of copies to print. Default is 1.
• --timeout (optional): Timeout in seconds for the network connection. Default is 10 seconds.

ZPLPrintDriver.exe --path "C:\path\to\your\file.zpl" --printer "192.168.1.100" --port 9100 --copies 2 --timeout 10

Print Over USB

To print using a USB connection, you need to obtain the vendorId and productId from your printer's properties. Use these values in the format USB:vendorId:productId. For example:

• --path (required): Full path to the ZPL file you want to send to the printer.
• --usb (required): Indicates that the operation will use USB.
• --vendor_id (required): Value extracted from the hardware identifier properties.
• --product_id (required): Value extracted from the hardware identifier properties.

Where to find values: USB\VID_0A5F&PID_0081, vendor_id and product_id, respectively.

ZPLPrintDriver.exe --path="example.zpl" --usb --vendor_id="0A5F" --product_id="0081"

---

Using from Various Programming Languages

Python Example (Network)

In Python, you can use the subprocess module to call ZPLPrintDriver.exe.

import subprocess

# Command to run the executable with arguments
command = [
    "ZPLPrintDriver.exe",
    "--path", "C:\\path\\to\\your\\file.zpl",
    "--printer", "192.168.1.100",
    "--port", "9100",
    "--copies", "1",
    "--timeout", "10"
]

# Execute the command
result = subprocess.run(command, capture_output=True, text=True)

# Print the output
print(result.stdout)

Python Example (USB)

In Python, you can use the subprocess module to call ZPLPrintDriver.exe.

import subprocess

# Command to run the executable with arguments
command = [
    "ZPLPrintDriver.exe",
    "--path", "C:\\path\\to\\your\\file.zpl",
    "--usb",
    "--vendor_id", "0A5F",
    "--product_id", "0081"
]

# Execute the command
result = subprocess.run(command, capture_output=True, text=True)

# Print the output
print(result.stdout)

C# Example

In C#, you can use the Process class to execute the command and interact with the output.

using System;
using System.Diagnostics;

class Program
{
    static void Main(string[] args)
    {
        // Create and configure the process
        Process process = new Process();
        process.StartInfo.FileName = "ZPLPrintDriver.exe";
        process.StartInfo.Arguments = "--path \"C:\\path\\to\\your\\file.zpl\" --printer \"192.168.1.100\" --port 9100 --copies 1 --timeout 10";
        process.StartInfo.RedirectStandardOutput = true;
        process.StartInfo.UseShellExecute = false;
        process.StartInfo.CreateNoWindow = true;

        // Start the process
        process.Start();

        // Read and display the output
        string output = process.StandardOutput.ReadToEnd();
        Console.WriteLine(output);

        // Wait for the process to exit
        process.WaitForExit();
    }
}

PHP Example

In PHP, the exec() function can be used to invoke the executable.

<?php
// Command to execute the ZPL print driver
$command = "ZPLPrintDriver.exe --path \"C:\\path\\to\\your\\file.zpl\" --printer \"192.168.1.100\" --port 9100 --copies 1 --timeout 10";

// Execute the command and capture the output
$output = shell_exec($command);

// Display the output
echo $output;
?>

Ruby Example

In Ruby, you can use the system() function to run the command.

# Command to run the ZPLPrintDriver.exe
command = 'ZPLPrintDriver.exe --path "C:\\path\\to\\your\\file.zpl" --printer "192.168.1.100" --port 9100 --copies 1 --timeout 10'

# Execute the command
system(command)

Visual Basic (VBScript) Example

In VBScript, you can use the WScript.Shell object to run the executable.

Set objShell = WScript.CreateObject("WScript.Shell")

' Command to run ZPLPrintDriver.exe
command = "ZPLPrintDriver.exe --path ""C:\path\to\your\file.zpl"" --printer ""192.168.1.100"" --port 9100 --copies 1 --timeout 10"

' Execute the command
objShell.Run command, 0, True

PowerShell Example

In PowerShell, you can execute the command using Start-Process.

# Define the command
$command = "ZPLPrintDriver.exe --path 'C:\path\to\your\file.zpl' --printer '192.168.1.100' --port 9100 --copies 1 --timeout 10"

# Execute the command
Start-Process -FilePath "cmd.exe" -ArgumentList "/c $command" -NoNewWindow -Wait

WScript (Windows Script Host) Example

In WScript, you can execute the command with Exec and capture the output.

var shell = new ActiveXObject("WScript.Shell");

// Command to run ZPLPrintDriver.exe
var command = 'ZPLPrintDriver.exe --path "C:\\path\\to\\your\\file.zpl" --printer "192.168.1.100" --port 9100 --copies 1 --timeout 10';

// Execute the command
var exec = shell.Exec(command);

// Read and print the output
while (!exec.StdOut.AtEndOfStream) {
    WScript.Echo(exec.StdOut.ReadLine());
}

JavaScript (Node.js) Example

In Node.js, use the child_process module to run the executable.

const { exec } = require('child_process');

// Command to run the executable
const command = 'ZPLPrintDriver.exe --path "C:\\path\\to\\your\\file.zpl" --printer "192.168.1.100" --port 9100 --copies 1 --timeout 10';

// Execute the command
exec(command, (error, stdout, stderr) => {
    if (error) {
        console.error(`Error: ${error.message}`);
        return;
    }
    if (stderr) {
        console.error(`Stderr: ${stderr}`);
        return;
    }
    console.log(`Stdout: ${stdout}`);
});

Excel VBA Example

In Excel VBA, you can execute the command using the Shell function.

Sub PrintZPL()

    ' Define the command arguments
    Dim zplFile As String
    Dim printerIP As String
    Dim printerPort As String
    Dim copies As Integer
    Dim timeout As Integer
    Dim command As String

    ' Set the values for the ZPL file path, printer IP, port, and other parameters
    zplFile = "C:\path\to\your\file.zpl"
    printerIP = "192.168.1.100"
    printerPort = "9100"
    copies = 1
    timeout = 10

    ' Create the full command string
    command = "ZPLPrintDriver.exe --path """ & zplFile & """ --printer """ & printerIP & """ --port " & printerPort & " --copies " & copies & " --timeout " & timeout

    ' Execute the command using the Shell function
    Shell command, vbNormalFocus

End Sub

F# Example

In F#, you can use the System.Diagnostics.Process class to execute the command similarly to C#.

open System.Diagnostics

let command = "ZPLPrintDriver.exe --path \"C:\\path\\to\\your\\file.zpl\" --printer \"192.168.1.100\" --port 9100 --copies 1 --timeout 10"

let process = new Process()
process.StartInfo.FileName <- "cmd.exe"
process.StartInfo.Arguments <- sprintf "/c %s" command
process.StartInfo.RedirectStandardOutput <- true
process.StartInfo.UseShellExecute <- false
process.StartInfo.CreateNoWindow <- true

process.Start() |> ignore
let output = process.StandardOutput.ReadToEnd()
printfn "%s" output
process.WaitForExit()

Rust Example

In Rust, you can use the std::process::Command module to execute the command.

use std::process::Command;

fn main() {
    let output = Command::new("ZPLPrintDriver.exe")
        .arg("--path")
        .arg("C:\\path\\to\\your\\file.zpl")
        .arg("--printer")
        .arg("192.168.1.100")
        .arg("--port")
        .arg("9100")
        .arg("--copies")
        .arg("1")
        .arg("--timeout")
        .arg("10")
        .output()
        .expect("Failed to execute process");

    println!("{}", String::from_utf8_lossy(&output.stdout));
}

Go Example

In Go, you can use the os/exec package to call the executable.

package main

import (
	"fmt"
	"os/exec"
)

func main() {
	cmd := exec.Command("ZPLPrintDriver.exe", "--path", "C:\\path\\to\\your\\file.zpl", "--printer", "192.168.1.100", "--port", "9100", "--copies", "1", "--timeout", "10")

	output, err := cmd.Output()
	if err != nil {
		fmt.Println("Error:", err)
		return
	}

	fmt.Println(string(output))
}

Kotlin Example

In Kotlin, you can use the ProcessBuilder class to run the command.

import java.io.BufferedReader
import java.io.InputStreamReader

fun main() {
    val command = listOf("ZPLPrintDriver.exe", "--path", "C:\\path\\to\\your\\file.zpl", "--printer", "192.168.1.100", "--port", "9100", "--copies", "1", "--timeout", "10")
    val process = ProcessBuilder(command).start()

    val reader = BufferedReader(InputStreamReader(process.inputStream))
    var line: String? = reader.readLine()
    while (line != null) {
        println(line)
        line = reader.readLine()
    }

    process.waitFor()
}

---

Error Handling

If there are any errors (e.g., invalid printer IP, file not found), the program returns a JSON response in the following format:

{
  "result": "Fail",
  "error": "Description of the error"
}

Successful Output

For successful execution, the output will look like this:

{
    "result": "Success",
    "file_path": "example.zpl",
    "copies": 1,
    "usb_connection": true,
    "execution_time": {
        "start_timestamp": "2024-09-30 12:44:28",
        "end_timestamp": "2024-09-30 12:44:28",
        "duration_seconds": 0.1
    }
}

---

License

This project is under the MIT License.

🌟 Support My Projects! 🚀

Make any contributions you see fit; the code is entirely yours. Together, we can do amazing things and improve the world of development. Your support is invaluable. ✨

If you have ideas, suggestions, or just want to collaborate, we are open to everything! Join our community and be part of our journey to success! 🌐👩‍💻👨‍💻