Repository navigation
Labelize Printer v0.2.0
Labelize Printer v0.2.0 adds a Labels workspace and visual label designer alongside the existing local virtual printer. Open label files, inspect their pages, and save PDF or PNG without a cloud service.
Labels workspace
- Open ZPL, EPL, TSPL/TSC, CPCL, DPL, and PRN files. File extensions and content detection select the language, with a manual override available.
- Edit supported UTF-8 source and preview every rendered page. Binary/control-byte input and files over 1 MiB remain read-only so the original bytes are preserved.
- Save one multipage raster PDF or one PNG per page through the existing background job queue. Workspace settings apply to that job without replacing the system queue's settings.
- Use Cmd/Ctrl+O, N, S, and 4 for opening, creating, saving, and switching to Labels. Edited documents prompt before they are discarded.
Visual label design
- Add text, Code 128, QR codes, rectangles, and images. Select and drag objects, edit millimetre coordinates and dimensions, and undo or redo changes.
- Save portable
.labelize.jsontemplates with embedded images and an optional imported TrueType/OpenType font. Import a suitable font for Chinese and other scripts; missing glyphs and overflowing text are reported. - Preview and output share the same rendering pipeline. Barcodes preserve integer module scaling and quiet zones; transparent images are composited over white.
- Existing printer-language files remain source documents. This release saves PDF/PNG; it does not reconstruct design objects from printer commands, export designs as printer commands, or submit directly to physical printers.
Recent jobs now identifies each source language and distinguishes designer templates from ZPL jobs.
The interface supports English and Simplified Chinese. Project documentation is now maintained in English, with a revised README and a dedicated development guide.
Install and upgrade
Download the installer for your platform and verify it against SHA256SUMS:
LabelizePrinter-0.2.0-windows-x64.exeLabelizePrinter-0.2.0-macos-arm64-release.pkgLabelizePrinter-0.2.0-macos-x86_64-release.pkglabelize-printer_0.2.0_amd64.deb
The Windows EXE and macOS PKGs are unsigned trial packages. macOS app bundles use ad-hoc signatures. Developer ID signing and notarization remain pending.
Before upgrading, let pending jobs finish, close the desktop, and stop the installed daemon. Keep desktop, daemon, and native adapter versions matched. Existing output and job history are retained. Once jobs or templates created by v0.2.0 are stored, older versions may not understand the new document input type; keep a data backup if you need to roll back.
On macOS:
brew install --cask goodboy008/labelize-printer/labelize-printerFor an existing Homebrew installation, stop the daemon, then run brew update and brew upgrade --cask goodboy008/labelize-printer/labelize-printer. Homebrew instructions
Validation and remaining acceptance
Release source: 7dae87c84f6e76ad59b32bba1428c756492066bc. Build and package
The final source passed all five CI jobs: formatting, macOS 15 Apple Silicon and Intel builds, Windows Server 2022 x64, and Debian 12 x64 in an Ubuntu 24.04 CI runner. Each platform passed the 11 core tests and its applicable daemon smoke tests. These cover direct label files and isolated preview workers, RAW job boundaries, page dimensions and copies, failure retention, restart recovery, and port conflicts. The macOS/Linux runs also verify IPP raster input and worker-crash recovery. The Linux installed-package test passed CUPS PDF filtering through PAPPL to a two-page PDF, followed by queue and package removal.
The new workspace was exercised locally on macOS 27.2 Apple Silicon: file opening, mixed-size multipage ZPL, Chinese text with an imported font, object movement, template save/reopen, undo/redo, PDF/PNG export, language switching, and narrow-window layout. Core tests cover all five file languages, byte-safe binary graphics, preview/output pixel equality, portable templates, PDF dimensions, and input validation.
Windows and Linux desktop acceptance for the new workspace has not been completed. The earlier Windows 11 ARM64 VM checks used x64 emulation and do not establish native Windows 11 x64 acceptance. ZDesigner v10 ZD421 ZPL system printing at 203/300 dpi is still unverified. macOS 13 on both architectures and Debian 12 X11 / Ubuntu 24.04 Wayland desktop acceptance also remain pending, including IME composition, portals, and login services. Acceptance record
Jobs remain local and self-contained. Limits include 64 MiB input, 1,000 pages, 16 Mi pixels per page, a 300-second render timeout, and 128 Mi pixels across preview pages. Copy semantics follow the embedded Labelize engine; ZPL ^PQ is expanded once by the existing integration.