ZELYRA HANDBOOK

Complete Language Guide & Technical Reference
Zelyra 1.3.1 (Commit e20d099)
Official Documentation · Stefan Siedelmann
https://siedelmann.com · November 2026

Software Handbook: Label Printing & Zebra Studio

Enterprise label printing straight from the browser: Visual WYSIWYG designer (ZPL II, TSPL/TSPL2, EPL2, CAB JScript), real scannable barcodes & QR codes, persistent media library with automatic ZPL ^GFA bitmap conversion, Zebra USB & network printing via WebUSB, Zebra Browser Print, and the Cloud Print-Bridge (Windows PowerShell & Linux systemd), Kiosk mode, Business Suite batch printing, and tenant-isolated REST API.


1. Overview & Architecture

The Label Printing & Zebra Studio module (/app/etiketten) is fully multi-tenant and bridges cloud-based template design with local industrial printing on Zebra, TSC, Godex, and CAB printers – as well as standard A4 office printers (Avery/Zweckform sheets).


2. Visual WYSIWYG Studio & Media Library


3. Sequential Counters, Expiry Dates & GS1-128

Placeholder Output
{{seq:0001}} Auto-incrementing serial number per printed copy (0001, 0002, 0003 …)
{{date+365d}} / {{date+6m}} Expiry / best-before date with day, month, or year offset
{{date_gs1+180d}} GS1 YYMMDD date format for GS1-128 AI (17)
{{week}} Current ISO calendar week

4. Supported Printer Brands, USB & Network Printing

The module is not limited to Zebra – thanks to four native printer compilers plus DIN A4 sheet output, you can run mixed fleets across virtually all industrial and office brands:

Language / Output Supported Manufacturers & Series
ZPL II Zebra (GK/GX, ZD420/421/621, ZT230/411/610) plus ZPL-compatible printers from Honeywell/Intermec, SATO, Citizen, Brother (TD/TJ), Toshiba TEC, Printronix, Carl Valentin
TSPL / TSPL2 TSC, Godex, Bixolon, Gprinter, HPRT
EPL2 Zebra LP/TLP 2844, Eltron
CAB JScript CAB (SQUIX, A+, MACH, EOS, HERMES)
A4 Sheets (Avery/Zweckform) Any standard office laser or inkjet printer (HP, Brother, Kyocera, Canon, Epson, etc.)

Cloud-Compatible Connection Modes

  1. Cloud Print-Bridge (Recommended for LAN printers behind firewalls – no VPN):
    • Configure your printer with connection type Cloud Print-Bridge, its local LAN IP (e.g. 192.168.1.50), and TCP port 9100.
    • Windows hidden autostart service: powershell -ExecutionPolicy Bypass -File .\siedelmann-print-bridge-install.ps1
    • Linux / Raspberry Pi systemd service: sudo bash siedelmann-print-bridge-install.sh
    • Live heartbeat indicator inside Printers & Bridge turns green (Bridge active) within seconds.
  2. WebUSB (Zero-Install): Direct USB printing to Zebra printers (0x0A5F) from Chrome/Edge – no local IP or software required.
  3. Zebra Browser Print: Install Zebra's free official desktop service (localhost:9100/9101), select your default USB/LAN Zebra printer, approve the web domain if prompted, and click Detect Zebra Browser Print inside Printers & Bridge.
  4. Avery / Zweckform A4 Sheets: Printable DIN A4 layouts with real scannable SVG barcodes, QR codes, logos, and configurable start offset for partially used sheets. In your browser print dialog, set Scale = 100% / Actual size and Margins = None.
  5. Zelyra Connect · WireGuard VPN (Included Free): Direct TCP port 9100 printing without any local script via Labels → VPN Tunnels (/app/etiketten/vpn). Download a 1-click .conf (or scan QR) for Fritz!Box, OPNsense, pfSense, Windows, or Linux. Every tenant tunnel runs in its own kernel-isolated Linux Network Namespace with a strict one-way firewall (INPUT/FORWARD DROP) and individual Preshared Key.

5. REST API

Authenticate with a tenant-scoped Bearer token (Authorization: Bearer <TOKEN>) against /api/v1/labels/templates, /api/v1/labels/printers, /api/v1/labels/print, and /api/v1/labels/jobs/{id}.