Convert, Preview & Render EPL commands to PNG, JPG & PDF from Docker!

EPLPrinter Web API for Docker allows you to Convert, Preview and Render raw EPL (Zebra/Eltron Programming Language) commands to well known image and document formats like PNG, JPG, PDF, PCX, Zebra GRF ASCII hex, Zebra EPL Binary Graphic, Honeywell-Intermec FingerPrint Binary Graphic, HP PCL Binary Graphic & EPSON ESC/POS NV Binary Graphic from Any Development Platform and Programming Languages (.NET, Java, PHP, Javascript, Python, Ruby, and more!)

Features at a Glance

Overview

Designed by following some of the REST principles, EPLPrinter Web API for Docker responds to a simple HTTP POST by specifying the EPL commands and printer settings through a JSON object in the request body, returning the output rendering in the image or document format specified through the Accept header.

Help Doc Topics

Download and run EPLPrinter Web API for Docker

EPLPrinter Web API for Docker is available at Docker Hub registry.

• To pull/download the Docker image, please type the following from a Terminal:

  AMD
  docker pull neodynamic/eplprinterwebapi:3.0.6
  ARM
  docker pull neodynamic/eplprinterwebapi:3.0.6-arm64

• To run the Docker image, please type the following from a Terminal:

  AMD
  docker run -it --rm -p 8080:8080 neodynamic/eplprinterwebapi:3.0.6
  ARM
  docker run -it --rm -p 8080:8080 neodynamic/eplprinterwebapi:3.0.6-arm64
   License Registration    Evaluation Mode Limitations    Change Log
  
  

  Special Parameters

  • Auto HTTPS Redirection: By default, HTTPS redirection is enabled. It can be disabled by specifying the following parameter -e "USE_HTTPS_REDIRECTION=false"
  • Swagger UI: By default, Swagger UI is enabled. It can be disabled by specifying the following parameter -e "SWAGGER_UI_ENABLED=false"

Run EPLPrinter WebAPI on a Custom Port

By default, our Docker image exposes port 8080 only. If you want to expose and use another different port, then do the following.

1. Let's suppose you want to use port 12345, then run the docker image with the following parameters:
   
   
   AMD

   docker run -it --rm -p 8080:12345 neodynamic/eplprinterwebapi:3.0.6 -e ASPNETCORE_HTTP_PORTS=12345

   ARM

   docker run -it --rm -p 8080:12345 neodynamic/eplprinterwebapi:3.0.6-arm64 -e ASPNETCORE_HTTP_PORTS=12345
2. Special case for port 80: If you need to use port 80, then run the docker image with the following parameters:
   
   
   AMD

   docker run -it --rm -p 8080:80 neodynamic/eplprinterwebapi:3.0.6 -u root -e ASPNETCORE_HTTP_PORTS=80

   ARM

   docker run -it --rm -p 8080:80 neodynamic/eplprinterwebapi:3.0.6-arm64 -u root -e ASPNETCORE_HTTP_PORTS=80

How To Use It - Basic Sample

The following source code invokes the EPLPrinter Web API for Docker to generate a PNG image for the specified EPL Commands. For more advanced settings please refer to the EPLPrintJob JSON Object

•   CURL
•   PHP
•   RUBY
•   PYTHON
•   PERL
•   JAVA
•   C#
•   JS/XHR
•   NODE

                    
curl -X POST "http://localhost:8080/EPLPrinter" \
     -H  "Accept: image/png" \
     -H  "Content-Type: application/json" \
     -d "{\"eplCommands\":\"N\r\nq609\r\nQ203,26\r\nB26,26,0,UA0,2,2,152,B,\"603679025109\"\r\nA253,26,0,3,1,1,N,\"SKU 6205518 MFG 6354\"\r\nA253,56,0,3,1,1,N,\"2XIST TROPICAL BEACH\"\r\nA253,86,0,3,1,1,N,\"STRIPE SQUARE CUT TRUNK\"\r\nA253,116,0,3,1,1,N,\"BRICK\"\r\nA253,146,0,3,1,1,N,\"X-LARGE\"\r\nP1\"}" \
     --output label.png
                        
                

                    
$data = array(
  'eplCommands' => 'N\r\nq609\r\nQ203,26\r\nB26,26,0,UA0,2,2,152,B,\"603679025109\"\r\nA253,26,0,3,1,1,N,\"SKU 6205518 MFG 6354\"\r\nA253,56,0,3,1,1,N,\"2XIST TROPICAL BEACH\"\r\nA253,86,0,3,1,1,N,\"STRIPE SQUARE CUT TRUNK\"\r\nA253,116,0,3,1,1,N,\"BRICK\"\r\nA253,146,0,3,1,1,N,\"X-LARGE\"\r\nP1'
);

$options = array(
  'http' => array(
    'method'  => 'POST',
    'content' => json_encode( $data ),
    'header' =>  "Content-Type: application/json\r\n" .
                "Accept: image/png\r\n"
    )
);

$context  = stream_context_create( $options );
$url = 'http://localhost:8080/EPLPrinter';
$response = file_get_contents( $url, false, $context );
file_put_contents('label.png', $response);
                        
                

                    
require 'net/http'
require 'uri'
require 'json'

uri = URI.parse("http://localhost:8080/EPLPrinter")

header = {'Accept':'image/png', 'Content-Type': 'application/json'}

data = {eplCommands: 'N\r\nq609\r\nQ203,26\r\nB26,26,0,UA0,2,2,152,B,\"603679025109\"\r\nA253,26,0,3,1,1,N,\"SKU 6205518 MFG 6354\"\r\nA253,56,0,3,1,1,N,\"2XIST TROPICAL BEACH\"\r\nA253,86,0,3,1,1,N,\"STRIPE SQUARE CUT TRUNK\"\r\nA253,116,0,3,1,1,N,\"BRICK\"\r\nA253,146,0,3,1,1,N,\"X-LARGE\"\r\nP1'}

http = Net::HTTP.new(uri.host, uri.port)
request = Net::HTTP::Post.new(uri.request_uri, header)
request.body = data.to_json

response = http.request(request)

open('/tmp/label.png', 'wb' ) { |file|
    file.write(response.body)
}
                        
                

                    
import requests
import json

url = "http://localhost:8080/EPLPrinter"

jsondata = json.dumps( {"eplCommands": "N\r\nq609\r\nQ203,26\r\nB26,26,0,UA0,2,2,152,B,\"603679025109\"\r\nA253,26,0,3,1,1,N,\"SKU 6205518 MFG 6354\"\r\nA253,56,0,3,1,1,N,\"2XIST TROPICAL BEACH\"\r\nA253,86,0,3,1,1,N,\"STRIPE SQUARE CUT TRUNK\"\r\nA253,116,0,3,1,1,N,\"BRICK\"\r\nA253,146,0,3,1,1,N,\"X-LARGE\"\r\nP1"} )

headers = {
    'content-type': "application/json",
    'accept': "image/png"
    }

response = requests.request("POST", url, data=jsondata, headers=headers)

if response.status_code == 200:
    with open("label.png", 'wb') as f:
        f.write(response.content)

                        
                

                    
use LWP::UserAgent;
my $ua = LWP::UserAgent->new;
my $server_endpoint = "http://localhost:8080/EPLPrinter";
my $req = HTTP::Request->new(POST => $server_endpoint);
$req->header('content-type' => 'application/json');
$req->header('accept' => 'image/png');

my $post_data = '{ "eplCommands" : "' + 'N\r\nq609\r\nQ203,26\r\nB26,26,0,UA0,2,2,152,B,\"603679025109\"\r\nA253,26,0,3,1,1,N,\"SKU 6205518 MFG 6354\"\r\nA253,56,0,3,1,1,N,\"2XIST TROPICAL BEACH\"\r\nA253,86,0,3,1,1,N,\"STRIPE SQUARE CUT TRUNK\"\r\nA253,116,0,3,1,1,N,\"BRICK\"\r\nA253,146,0,3,1,1,N,\"X-LARGE\"\r\nP1' + '" }';

$req->content($post_data);

my $resp = $ua->request($req);
open FILEHANDLE, ">label.png";
print FILEHANDLE $resp->{_content};
close FILEHANDLE;
                        
                

                    
CloseableHttpClient client = HttpClients.createDefault();
HttpPost httpPost = new HttpPost("http://localhost:8080/EPLPrinter");
 
String json = "{\"eplCommands\" : \"" + "N\r\nq609\r\nQ203,26\r\nB26,26,0,UA0,2,2,152,B,\"603679025109\"\r\nA253,26,0,3,1,1,N,\"SKU 6205518 MFG 6354\"\r\nA253,56,0,3,1,1,N,\"2XIST TROPICAL BEACH\"\r\nA253,86,0,3,1,1,N,\"STRIPE SQUARE CUT TRUNK\"\r\nA253,116,0,3,1,1,N,\"BRICK\"\r\nA253,146,0,3,1,1,N,\"X-LARGE\"\r\nP1" + "\"}";
StringEntity entity = new StringEntity(json);
httpPost.setEntity(entity);
httpPost.setHeader("Accept", "image/png");
httpPost.setHeader("Content-type", "application/json");
 
CloseableHttpResponse response = client.execute(httpPost);
HttpEntity entity = response.getEntity();
if (entity != null) {
    try (FileOutputStream outstream = new FileOutputStream(new File("label.png"))) {
        entity.writeTo(outstream);
    }
}
client.close();     
                        
                

                    
string DATA = "{\"eplCommands\" : \"" + "N\r\nq609\r\nQ203,26\r\nB26,26,0,UA0,2,2,152,B,\"603679025109\"\r\nA253,26,0,3,1,1,N,\"SKU 6205518 MFG 6354\"\r\nA253,56,0,3,1,1,N,\"2XIST TROPICAL BEACH\"\r\nA253,86,0,3,1,1,N,\"STRIPE SQUARE CUT TRUNK\"\r\nA253,116,0,3,1,1,N,\"BRICK\"\r\nA253,146,0,3,1,1,N,\"X-LARGE\"\r\nP1" + "\"}";

var request = (HttpWebRequest)WebRequest.Create("http://localhost:8080/EPLPrinter");
request.Method = "POST";
request.ContentType = "application/json";
request.ContentLength = DATA.Length;
request.Accept = "image/png";

using (var requestWriter = new StreamWriter(request.GetRequestStream(), System.Text.Encoding.ASCII)){
    requestWriter.Write(DATA);
}

var webResponse = request.GetResponse();
using (var stream = webResponse.GetResponseStream())
using (var fileStream = File.OpenWrite("label.png"))
{
    var bytes = new byte[4096];
    var read=0;
    do
    {
        if (stream == null) {continue;}
        read = stream.Read(bytes, 0, bytes.Length);
        fileStream.Write(bytes, 0, read);
    } while (read != 0);
}

                        
                

                    
var data = JSON.stringify({
    "eplCommands": "N\r\nq609\r\nQ203,26\r\nB26,26,0,UA0,2,2,152,B,\"603679025109\"\r\nA253,26,0,3,1,1,N,\"SKU 6205518 MFG 6354\"\r\nA253,56,0,3,1,1,N,\"2XIST TROPICAL BEACH\"\r\nA253,86,0,3,1,1,N,\"STRIPE SQUARE CUT TRUNK\"\r\nA253,116,0,3,1,1,N,\"BRICK\"\r\nA253,146,0,3,1,1,N,\"X-LARGE\"\r\nP1"
});

var xhr = new XMLHttpRequest();
xhr.withCredentials = true;

xhr.addEventListener("readystatechange", function () {
    if (this.readyState === 4) {
    console.log(this.responseText);
    }
});

xhr.open("POST", "http://localhost:8080/EPLPrinter");
xhr.setRequestHeader("content-type", "application/json");
xhr.setRequestHeader("accept", "image/png");

xhr.send(data);
                        
                

                    
var request = require('request');
 
var headers = {
    'Accept': 'image/png',
    'Content-Type': 'application/json'
}
 
var options = {
    url: 'http://localhost:8080/EPLPrinter',
    method: 'POST',
    headers: headers,
    json: {"eplCommands": "N\r\nq609\r\nQ203,26\r\nB26,26,0,UA0,2,2,152,B,\"603679025109\"\r\nA253,26,0,3,1,1,N,\"SKU 6205518 MFG 6354\"\r\nA253,56,0,3,1,1,N,\"2XIST TROPICAL BEACH\"\r\nA253,86,0,3,1,1,N,\"STRIPE SQUARE CUT TRUNK\"\r\nA253,116,0,3,1,1,N,\"BRICK\"\r\nA253,146,0,3,1,1,N,\"X-LARGE\"\r\nP1"}
}
 
request(options, function (error, response, body) {
    if (!error && response.statusCode == 200) {
        console.log(body);
    }
})
                        
                

The Accept Header

The desired output rendering format must be specified through the Accept header. The supported formats are the following:

Web API Doc

EPL Commands Support

EPLPrinter Web API rendering engine supports most of the EPL formatting and control commands. The following table lists the supported commands. Not listed or unsupported commands will be skipped in the parsing stage.

Licensing

On-Premise - Full Deployment Control

EPLPrinter Web API is licensed for Private On-Premise environments giving you full control on the infrastructure where our product will run on. Please refer to Licensing model and prices...

 License Registration

When you buy a commercial license of EPLPrinter Web API for Docker, you are provided with license information (LicenseOwner & LicenseKey) to register the product. The license information must be specified to the Docker image as environment variables as folows:

 Change Log

• 3.0.6 2026-01-26
  • CRITICAL Fixed! Port 80 is no longer the default port. Changed to port 8080. This change now allows non-root users.
  • Fixed! Updated all third-party libs and dependencies that are free of known vulnerabilities.
  
  
• 3.0.5 2025-05-21
  • New! Added support for parameter SWAGGER_UI_ENABLED to enable/disable Swagger UI.
  
  
• 3.0.4 2024-12-31
  • New! Added curl to Linux AMD image.
  • New! Added support for parameter USE_HTTPS_REDIRECTION to enable/disable auto HTTPS redirection.
  
  
• 3.0.3 2024-10-10
  • Fixed! Z command was not being parsed.
  
  
• 3.0.2 2024-06-03
  • Fixed! GW parsing when LF char is part of the encoded data.
  
  
• 3.0.1 2024-04-24
  • Fixed! Added HTTP Response Headers for security.
  
  
• 3.0 2023-12-06
  • New! Support for TS (Set Real-Time Clock) command.
  • New! Support for TD (Date Recall & Format Layout) command.
  • New! Support for TT (Time Recall & Format Layout) command.
  • New! Added HP PCL Binary output format rendering. This allows converting EPL commands to HP PCL graphic format.
  • New! Added EnablePrinting prop to format the output rendering commands for printing scenarios.
  
  
• 2.0 2023-03-16
  • New! Added support for FE (End Form Store), FK (Delete Form), FR (Retrieve Form) and FS (Store Form) forms-related commands.
  • New! Added support for V (Define Variable) command.
  • New! Added support for C (Counter) command.
  • New! Added support for ? (Download Variables) command.
  • New! Added InvertColors property to reverse the pixel colors of the output image.
  • New! Added CompressionQuality property to specify the compression quality level of the output image (JPG/JPEG format only).
  • New! Automatic PNG output optimization reducing the file/stream size.
  • New! Added traceRenderedElements property. It will return the list of EPL commands that are rendered including the location and size. Available for JSON outputs only.
  
  
• 1.0.4 2022-06-30
  • Fixed! Maxicode rendering when max data capacity needs to be encoded
  • Fixed! DataMatrix module size setting
  • Fixed! PDF417 rendering size and location
  • Fixed! GW parsing when present with an invalid format
  
  
• 1.0.3 2022-06-24
  • Fixed! Maxicode encoding when no LPM is specified.
  • Fixed! Maxicode rendering location.
  
  
• 1.0.2 2022-06-11
  • Fixed! Commands parsing generate overlapped labels rendering.
  
  
• 1.0.1 2022-05-04
  • Fixed! Graphic commands parsing errors.
  
  
• 1.0 2022-03-16
  • New! Initial release.