Skip to content

Label Editor

This page tracks what the label template system does today and what is planned. The user-facing guide is Label 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.
  • 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.
  • 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_COMMAND set, 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.
  • Renderer: backend/pkgs/labelmaker/template_renderer.go parses the Fabric.js JSON and draws text, barcodes, shapes and images onto an RGBA image at the template DPI. Image elements accept data: 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.go places labels on Avery-style layouts; SkipLabels offsets the first sheet and a nil entity leaves its slot empty. A template’s own sheet_layout overrides its preset’s, and offset_x/offset_y are added to the margins (sheetLayoutFor and pdfOptionsFor in the handler).
  • Entities: items and locations render from one labelmaker.EntityData built by buildEntityData in the handler, so every field works on both; only the page links (item_url, location_url, url) differ. Item counts use GetItemCountByGroup, which counts by effective location.
  • 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.