# qzind/tray

Browser plugin for sending documents and raw commands to a printer or attached device.

Repository: https://github.com/qzind/tray
Canonical: https://ross.abutalabs.com/products/qzind-tray
Homepage: https://qz.io
Language: Java
License: NOASSERTION
License Family: other
Topics: zpl, epl, escpos, escp, zebra, epson, star, javascript, nodejs, promises, hidapi
Last push: 2026-09-02T20:01:47+00:00

## Health v2 (maintenance only)
Score: 81/100 (v2, computed 2026-09-03T02:20:16.233290+00:00)
- activity 100, release rhythm 46, longevity 100
- inputs: {"age_days": 3849, "days_push": 0, "days_rel": 151, "gap_med": 296, "n_releases_24m": 2}
- flags: no_license
- formula: round(0.45*activity + 0.35*rhythm + 0.20*longevity); archived -> min(score, 10)

## Adoption (not part of the score)
Stars 1051, forks 345 (observed 2026-09-03T02:15:17.219280+00:00)

## What it is
QZ Tray is a cross-browser, cross-platform desktop plugin that lets web pages send documents (PDF, HTML, images) and raw printer commands (ZPL, EPL, ESC/POS, ESC/P, etc.) to printers and attached devices. It also supports serial, HID, USB, socket, and file communication with hardware like scales, bridging the gap between browsers and local peripherals.

## Use cases
- print barcode labels from a web app to a Zebra thermal printer
- send raw ESC/POS commands to a receipt printer from the browser
- print PDFs silently without print dialogs from a web application
- communicate with a USB or serial scale from a web page
- print HTML or image documents to any installed printer from JavaScript
- send ZPL label data to a thermal printer from a web-based POS
- read from HID devices in a browser-based kiosk app

## When to choose
- you need browser-based printing to thermal, label, or receipt printers with raw command languages
- you need silent printing without user pop-ups in a web application
- your web app must talk to local serial, USB, or HID hardware
- you need cross-platform (Windows/macOS/Linux) printer access from JavaScript

## When to avoid
- you only need standard browser printing via window.print()
- you want a purely server-side printing solution with no client software install
- you need a fully free solution without any commercial licensing for silent printing
- your users cannot install desktop software or trusted certificates

## Facets
- artifact type: plugin
- maturity: active
- function: sdk, developer-tools, file-system
- domain: hardware, web-development, cross-platform
- platform: windows, browser, jvm, cross-platform
- tags: raw-printing, zpl, escpos, epl, thermal-printer, barcode-labels, hid, serial-communication, usb, silent-printing, receipt-printing, browser-to-hardware, printing, automation, macos, linux, javascript, desktop

## Member repositories
- qzind/tray (main) score 81

## Provenance
- Observed fields: from GitHub, fetched 2026-09-03T02:15:17.219280+00:00.
- Health v2: computed from the inputs above; adoption is never an input.
- Inferred fields (summary, facets, guidance): AI-extracted, prompt v1, taxonomy v1, on 2026-08-30T07:00:24.329162+00:00, confidence not recorded.
  - readme: https://github.com/qzind/tray (fetched 2026-09-03T02:15:17.219280+00:00, sha 36a6c93b560e)
  - homepage: https://qz.io (fetched 2026-08-29T13:01:53.404575+00:00, sha a20be5929721)
  - site_page: https://qz.io/docs (fetched 2026-08-29T13:01:53.413739+00:00, sha 7a2407a5268f)
  - site_page: https://qz.io/about (fetched 2026-08-29T13:01:53.415653+00:00, sha 0b350d981f61)
  - site_page: https://qz.io/docs/getting-started (fetched 2026-08-29T13:01:53.417292+00:00, sha 0f211dff8520)
  - site_page: https://qz.io/docs/signing (fetched 2026-08-29T13:01:53.419053+00:00, sha 298efa6746c7)
  - site_page: https://qz.io/docs/what-is-raw-printing (fetched 2026-08-29T13:01:53.421092+00:00, sha de9d46bcafa2)
  - site_page: https://qz.io/docs/company-branded (fetched 2026-08-29T13:01:53.423127+00:00, sha f2d66f28212a)
  - site_page: https://qz.io/docs/licensing (fetched 2026-08-29T13:01:53.424961+00:00, sha 1535bf2cfa57)
  - site_page: https://qz.io/docs/company-branded-service-terms-of-use (fetched 2026-08-29T13:01:53.426656+00:00, sha ffd8ca6fd6e6)
- Data as of 2026-08-30T08:39:29.467469+00:00.