2.2.6

2026-04-04

Fixes

• Prevent race condition in websocket connection #1350
• Windows: Fix installation as SYSTEM user #1361
• Better locking and concurrency support for hardware IO (serial, network, files, usb) #1415
• Better compat with .NET embedded Trident browsers #1408
• Substitutions: Fix null handling #1371, #1371
• Log Dialog: Fix major performance issues, improve look & feel #1385
• JS: Add support for web / service workers #1379

Features

• Printing: Add compat for arbitrarily sized images: #1419
• Printing: Add ESC/POS raw image support for GS v 0 and GS ( L #1364, #1391
• Linux: Add experimental support for user-scoped installations #1423
• Apple: Add liquid-glass-compatible icon #1412
• Provisioning: Add support for browser policies #1404
• Provisioning: Add support for resource bundling and re-use #1363, #1380
• Headless: Allow forwarding of allow/block dialogs in headless environments #1420
• Company Branded: Add branding capabilities to JS lib #1399
• Print Server: Non-qualified domains will automatically add .qz.surf extension for a future product. Set qz.websocket.usingSurf(false) to disable. #1429

Maintenance

• Add unit tests via TestNG framework #1403
• Refactor raw image handling #1391
• Add build artifacts to CI #1395

Security

• Bump dependent libs, JDK

Full Changelog: v2.2.5...v2.2.6

2.2.5

2025-06-12

Security

• WebSocket: Add support for HTTP origin filtering #1236

Features

• Provisioning: Add support for self-signed certs #1313
• Provisioning: Add support for configuring proxy connections #1325

Fixes

• Pixel Printing: Fix handling of empty images 71c1c48
• Pixel Printing: Fix page handling with scaleContent: false #1295
• Raw Printing: Fix regression with Vietnamese codepages #1290, #281
• Windows: Remove WMIC dependency #1334
• Windows Printers: Fix status reporting for network-attached printers #1344
• Windows Printers: Fix qz.printers.clearQueue #1305
• macOS: Suppress Rosetta 2 prompt on Apple Silicon #1284
• WebSocket: Improve handling of ClosedChannelException #1300
• File IO: Filter file events for "breadcrumb" files #1279
• Socket IO: Fix encoding and endless callbacks #1283
• Printer Details: Fix driver name for AirPrint printers #1280
• Provisioning: Fix IndexOutOfBoundsException when matching certain file extensions #1331
• Signing: Fix reentry race condition with qz.security.setSignatureAlgorithm #1302
• Site Manager: Always show time zone for certificate expiration #1289

Maintenance

• Initial support for Java 21 #1222
• Update code-signing certificates for Apple, Windows #1330, #1336
• Update demo page certificate #1293
• Add support for bundling 32-bit JDKs 33824c3
• This tag also includes the following fixes from 2.2.4+2: #1282, #137, #1265

Full Changelog: v2.2.4...v2.2.5

2.2.4

2024-07-19

Security

• Printing to a file has been disabled. It can be enabled via security.print.tofile (#1213)
• Printing from non-HTTP/non-HTTPS origins is disabled. It can be enabled via security.data.protocols (#1213)
• Additional system properties to harden file reading/writing (#1213)

Features

• Substitutions: Allow JSON data substitutions client-side (#1258)
  • https://qz.io/docs/substitutions
• Provisioning: Add custom deployment provisioning support (#1190, #1263)
  • https://qz.io/docs/provisioning
• Demo: Add file drag-and-drop support (#1219)
• Demo: Add ESC/POS sample file to demo (#1228)
• Printing: Added 'default' ColorType (#1247)
• Printing: Add 'legacy' ESCPOS striping support (#1254)
• Linux: Provide basic support for Linux ARM32 (#1207)
• Linux: Add initial Linux RISC-V support (#1208)

Fixes:

• Signing: Raise signing exceptions to the call stack (#1273)
• Printing: Fix "PrintService is no longer available" (4748186)
• Printing: Fix PDF rendering issues with thin lines #1171
• Printer Status: Don't throw status warnings for job deletions (#1252)
• WebSocket: Disable SNI checks for HTTPS (#1215)
• Serial: Add missing serial support for 2400 baud (#1211, #476)
• Windows: Fix hard crash when accessibility is enabled (#1240)
• Windows: Fix hard crash when autostart folder is missing on Windows (#1262)
• macOS: Fix macOS title bar for dark mode (#1217)
• macOS: Fix HID hard crash #1267
• Linux: Fix gsettings exception on Linux (#1209)
• Linux: Improve Linux HiDPI Support (#1266, #1282)
• Company Branded: Fix color system tray icons for Company Branded builds (#1221)

Developer:

• Consolidate and simplify SSL cert save logic (#1223)

Full Changelog: v2.2.3...v2.2.4

2.2.3

2023-10-26

Features

• Allow cancelling of a WebSocket while connecting #1117
• Allow printer details to report page sizes #1148
• Allow IDE to close running instances #1147
• Add support for Gnome Epiphany browser #1131
• Add native support for Uint8Array types #1098
• Add alternate PDF font rendering technique #1108
• Add debugging to Apple installer #1151
• Make logs size and rotation configurable #1163
• Add support for JPEG2000 #1169
• Allow setCertificatePromise to be rejectable #1172

Fixes

• Fixes duplex printing on MacOS (JDK-8314772)
• Fix a slowdown/deadlock scenario with printer statuses: #1124 #1181
• Honor auostart preference on Linux #1091
• Fix corrupted UTF8 characters when printing 'plain' HTML #1097
• Fix Firefox ESR on Debian #1115
• Fix rotating images in headless environment #1119
• Prevent socket deadlocks #1146
• Ensure log files always end in ".log" #1160
• Fix edge-case deadlock with HTML pages #1184
• Prevent long running operations from blocking WebSocket pings #1177
• Fix File IO bug with listening on a specific folder #1202

Developer Notes

• Provide ability to specify a local, custom Java build #1084

Full Changelog: v2.2.2...v2.2.3

2.2.2

2023-01-18

Features:

• General: Adds bundled Java runtime #770, #841
• General: New installer artwork #770
• Raw: Add IGP/PGL Printronix support #1036
• Pixel: Allow PDFs with transparent layers to be printed in high quality #959
• Pixel: Allow page-range support for PDFs #919
• Printers: Better performance when finding printers #936
• Printers: Better detection of offline USB printers #979
• Printer Status: Add ability to monitor printer contents #923
• Printer Status: Better support for CUPS SNMP statuses #1017
• File IO: Add base64, hex flavors #1046
• Serial: Allow hex values in demo page #949
• API: Rename altPrinting to forceRaw #770

Fixes:

• 2.2.2+1: Fix UTF-8 encoding for HTML on Windows #1096
• General: Bump all dependencies #1000, #1057
• General: Properly display unicode characters in Log Window #1052
• General: Better "Zip Log to Desktop" support for OneDrive clients
• General: Fix certificate renewal for custom deployments using shared directories #916
• General: Better warnings when installing on incorrect architecture #875, #1027, #1030
• General: Fix edge-case with "Allow" dialog positioning #1013
• General: Don't log bad signatures for calls that don't require it #993
• Windows: Fix installer crash under certain environments #968
• Linux: Remove System Tray support #997
• Linux: Fix compatibility with several browsers: #989,
• MacOS: Fix override.crt missing from custom compiles #899
• Documentation: Add qz.api.isVersionGreater, qz.api.isVersionLess #900
• Documentation: Add default auto orientation #950
• Documentation: Add Vue.js signing example
• JS: Fix npm module compat for ReactJS projects #1045
• JS: Better Promise detection in setCertificatePromise #908
• Pixel: Add missing crypto module with newer BouncyCastle versions #902
• Pixel: Fix crash with empty Printer Tray names #904
• Pixel: Fix incorrect number of pages when HTML spans more than one page #911
• Linux: Properly detect/warn if Firefox 94 is running
• Compat: Better upgrade handling of altPrinting vs forceRaw #901
• HID: Backwards compatibility fix for HID/USB #951
• File IO: Create parent directories when using File IO #920
• Networking: Allow hostname to be retrieved without finding primary adapter #994

Full Changelog: v2.2.1...v2.2.2

2.1.6

2022-03-25

Features:

• Faster printer searching #932 #935 #940

Fixes:

• Fixes Java not being detected in certain scenarios #938
• Fix a JavaFX startup crash in certain environments #924
• Fix a benign UI hang when background tasks are running #933
• Update Jetty 9.4.21 -> 9.4.45 #943
• Update Log4J 2.17.1 -> 2.17.2

Full Changelog: v2.1.5...v2.1.6

2.2.1

2021-12-16

Features:

• Add SSL support for Firefox Developer/Nightly on MacOS #891

Fixes:

• Suppress warnings related to missing CA cert files #887
• Remove duplicate firewall rules on uninstall #884
• Update Log4J 1.2 -> 2.16 #896

Full Changelog: v2.2.0...v2.2.1

2.1.5

2021-12-16

Features:

• Add SSL support for Firefox Developer/Nightly on MacOS #891

Fixes:

• Suppress warnings related to missing CA cert files #887
• Remove duplicate firewall rules on uninstall #884
• Update Log4J 1.2 -> 2.16 #896

2.2.0

2021-10-06

Features:

• Adds bundled Java runtime #770
• Moves native libraries fixed location #841
• Renames altPrinting to forceRaw #770
• New installer artwork #770
• Initial support for sandboxed environments #770

Fixes:

• Fix sha256 when used with Node and insecure pages #871

Developer Notes:

• Adds experimental .dmg creation support #770

2.1.4

2021-08-23

Features:

• Adds Java 16 support #826
• Adds detection for Eclipse Adoptium Java df43410
• Adds native Apple Silicon Mac M1 (ARM64) support #591
• Adds native Windows Surface Pro X (ARM64) support #605*
• Adds dedicated debugging console qz-tray-console.exe for Windows #828
• Adds configuration option for primary network adapter #838
• Run background tasks when idle; improve performance #797
• Adds support for 2nd instance of QZ Tray to shutdown existing instance #849
• Better promise handling when signing fails #836
• Adds SATO SBPL raw language support #847

Fixes:

• Fixes port 8181 binding when already in use #812
• Fixes lingering Windows startup entries #816
• Fixes lingering Windows start menu entry #596
• Better handling of serial newline delimitation #800
• Workaround for Java 8 regression JDK-8266929 #819
• Various JDK16 fixes #823

* JavaFX (HTML) features are not yet available for Windows Surface Pro X ARM64

v2.1.3...v2.1.4