@bobfrankston/brother-label 1.1.10 → 1.1.11
This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
- package/README.md +26 -2
- package/package.json +1 -1
package/README.md
CHANGED
|
@@ -5,7 +5,7 @@ Print labels to Brother P-touch label printers from Node.js. Supports text, HTML
|
|
|
5
5
|
## Installation
|
|
6
6
|
|
|
7
7
|
```bash
|
|
8
|
-
npm install - @bobfrankston/brother-label
|
|
8
|
+
npm install -g @bobfrankston/brother-label
|
|
9
9
|
```
|
|
10
10
|
|
|
11
11
|
## Command Line Usage
|
|
@@ -83,6 +83,10 @@ brother-print -clip # auto-detect: image if present, else text
|
|
|
83
83
|
| `-no-wait` | Fail immediately if printer is offline (default: wait) |
|
|
84
84
|
| `-timeout <secs>` | Max wait time when printer is offline |
|
|
85
85
|
| `-interval <secs>` | Polling interval while waiting (default: 2) |
|
|
86
|
+
| `-ql <host>` | Print to a Brother QL series printer over TCP/9100 (e.g. `-ql ql720` or `-ql 1.2.3.4`); auto-set when `-p` resolves to a QL-* queue |
|
|
87
|
+
| `-ql-media <id>` | QL media firmware id (271 = DK-11201 29×90mm, 259 = DK-22205 62mm continuous); only needed when status detection and the Windows driver both fail |
|
|
88
|
+
| `-vb, -verbose` | Print extra QL diagnostic messages (status outcome, media source) |
|
|
89
|
+
| `-mdns` | With `list`: also discover network printers via mDNS |
|
|
86
90
|
|
|
87
91
|
Single-hyphen long options are supported: `-text` works the same as `--text`, `-tape` as `--tape`, etc. Single letters are strict: `-t` means `--text`, not the start of `-tape`.
|
|
88
92
|
|
|
@@ -90,6 +94,24 @@ Single-hyphen long options are supported: `-text` works the same as `--text`, `-
|
|
|
90
94
|
|
|
91
95
|
By default `print()` waits for the printer to come online if it's asleep. Use `-no-wait` to fail immediately, or `-timeout <secs>` to bound the wait. Use `brother-print status` to check the current online state. The wait reports any other Brother printers that are online as alternatives.
|
|
92
96
|
|
|
97
|
+
### QL series printers (DK die-cut / continuous labels)
|
|
98
|
+
|
|
99
|
+
QL printers (e.g. QL-720NW, QL-820NWB) print over raw TCP/9100, not via the Windows XPS driver. When `-p` resolves to a `QL-*` queue, brother-label auto-routes through the QL path and pulls the host from the printer port; you can also use `-ql <host>` directly to skip the queue lookup.
|
|
100
|
+
|
|
101
|
+
Media is auto-detected in this priority order:
|
|
102
|
+
1. Printer status response (newer QL models reply over TCP)
|
|
103
|
+
2. Windows print driver's cached media (DefaultPrintTicket XML)
|
|
104
|
+
3. `-ql-media <id>` override
|
|
105
|
+
|
|
106
|
+
If the bare hostname stored in the printer port doesn't resolve via DNS (common with Brother's `BRWxxxx` names), brother-label tries OS DNS suffixes, `.local` mDNS, then a direct multicast mDNS query.
|
|
107
|
+
|
|
108
|
+
```bash
|
|
109
|
+
brother-print -p ql720 "Hello" # auto-routes to QL TCP path
|
|
110
|
+
brother-print -ql 172.20.1.127 "Hello" # explicit host
|
|
111
|
+
brother-print -ql ql720 -ql-media 271 "Hello" # force DK-11201
|
|
112
|
+
brother-print -p ql720 -vb "Hello" # verbose: show status / media source
|
|
113
|
+
```
|
|
114
|
+
|
|
93
115
|
## API Usage
|
|
94
116
|
|
|
95
117
|
### Print text
|
|
@@ -244,7 +266,9 @@ interface PrintResult {
|
|
|
244
266
|
|
|
245
267
|
- Brother PT-P710BT (tested)
|
|
246
268
|
- Other Brother P-touch printers (should work)
|
|
247
|
-
- Brother QL
|
|
269
|
+
- Brother QL-720NW (tested via TCP/9100; status detection unsupported by firmware, falls back to Windows-driver media)
|
|
270
|
+
- Brother QL-820NWB (tested via TCP/9100)
|
|
271
|
+
- Other QL series (should work — protocol is shared)
|
|
248
272
|
|
|
249
273
|
## Requirements
|
|
250
274
|
|