Label Editor
This page tracks what the label template system does today and what is planned. The user-facing guide is Label Templates.
Implemented
Section titled “Implemented”Templates
Section titled “Templates”- Create, edit, duplicate, delete and export (JSON) templates; share a template with the collection.
- Presets for Avery sheet labels, Brother DK rolls, Dymo, Brady and Zebra stock, plus custom sizes.
- A per-user default template (synced preference) used by Quick print.
- List cards show a server-rendered thumbnail of each design.
Editor
Section titled “Editor”- Fabric.js canvas with rulers, zoom (fit, 25–400%), grid and snap; mm or inch units everywhere.
- Elements: text (auto-fit, bold, alignment, colour), barcodes (QR, DataMatrix, Code 128, Code 39, EAN-13, EAN-8, UPC-A) with compatibility-filtered data sources, rectangles, lines and embedded raster images (data URLs).
- Data field placeholders for item, location and common fields, including custom fields.
- Align the selection to the label edges or centre; nudge with the arrow keys; undo and redo.
- Inspector with Element, Layers and Label tabs; the Label tab holds name, description, preset, size, orientation, DPI and sharing.
- Live print preview rendered by the backend with a real item, and a Test print that sends the preview label through the server print command.
- Responsive layout: tool rail and inspector stack under the canvas on narrow screens.
Printing
Section titled “Printing”- One Print label split button on items and locations: quick print with the default template, the full dialog, PNG
download. The legacy built-in QR label (
LabelMaker.vue) is gone; the Asset ID Labels page renders a template over an asset ID range (POST /v1/label-templates/{id}/render-assets). - Print dialog with template cards, per-entity copies and three destinations: Label printer (only when the server
has
HBOX_LABEL_MAKER_PRINT_COMMANDset, disabled for sheet templates), This browser (print window) and Download (PNG, or PDF for several labels or sheets). - Bulk print from any item list, including a bulk Quick print; batch print page for items or locations with print order, copies, sheet options (skip first, cut guides, paper size) and a first-sheet preview.
- HomeBox does not print directly: there is no IPP/CUPS/Brother support and no WebUSB or Web Bluetooth. Server-side printing goes through the configured print command.
Backend notes
Section titled “Backend notes”- Renderer:
backend/pkgs/labelmaker/template_renderer.goparses the Fabric.js JSON and draws text, barcodes, shapes and images onto an RGBA image at the template DPI. Image elements acceptdata:URLs only; remote URLs are not fetched. - Printing: template printing calls the labelmaker print-command runner (
labelmaker.PrintPNG) with the rendered PNG. HomeBox never speaks a printer protocol. - Sheets:
pdf_renderer.goplaces labels on Avery-style layouts;SkipLabelsoffsets the first sheet and a nil entity leaves its slot empty. A template’s ownsheet_layoutoverrides its preset’s, andoffset_x/offset_yare added to the margins (sheetLayoutForandpdfOptionsForin the handler). - Entities: items and locations render from one
labelmaker.EntityDatabuilt bybuildEntityDatain the handler, so every field works on both; only the page links (item_url,location_url,url) differ. Item counts useGetItemCountByGroup, which counts by effective location.
Planned
Section titled “Planned”- Templates scoped to an entity type (for example a different default for containers).
- Template import from JSON and a small gallery of starter designs.
- Smart guides (snap to other elements) and multi-select alignment.
- Barcode content from custom fields.
- Print history with job status, and printing through API keys for print-on-scan automations.
- Several named print commands (for example a roll printer and a sheet printer) selectable per user.
- Text along a path, character spacing and outlines.