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
^GFAbitmap conversion, Zebra USB & network printing via WebUSB, Zebra Browser Print, and the Cloud Print-Bridge (Windows PowerShell & Linuxsystemd), 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
- Design labels in millimeters (
203 / 300 / 600 DPI) with Fullscreen Studio mode (Escto exit), auto-fit zoom, millimeter rulers, grid snap, rotation (0°/90°/180°/270°), alignment helpers, duplicate (Ctrl+D), undo (Ctrl+Z), and arrow-key nudging (0.5 mm/Shift:2 mm). - Upload logos and pictograms once into the Tenant Media Library – every graphic is automatically converted into 1-bit monochrome ZPL
^GFAcommands for Zebra printers and embedded cleanly in A4 sheets.
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
- 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 port9100. - 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.
- Configure your printer with connection type Cloud Print-Bridge, its local LAN IP (e.g.
- WebUSB (Zero-Install): Direct USB printing to Zebra printers (
0x0A5F) from Chrome/Edge – no local IP or software required. - 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. - 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.
- Zelyra Connect · WireGuard VPN (Included Free): Direct TCP port
9100printing 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}.
