# Command-line printing (Windows) Print a `.pos` template without opening the GUI. Run `posprint cli-help` to print this section from the binary (no GUI required). ## Syntax ```powershell posprint list posprint print --printer --set Name=Value [--set Other=Value ...] posprint link ``` Short form: ```powershell posprint list posprint print receipt.pos -p COM3 --set StoreName="My Shop" --set DocumentNumber=1001 posprint link receipt.pos ``` ## Rules - **`posprint list`**: print discovered printers (USB, spooler, USB-serial, paired Classic Bluetooth SPP). - **`--printer` / `-p`** (required): serial port (`COM3`, including a Bluetooth SPP COM after OS pairing), or a Windows printer queue name for spooler printing. - **`--set NAME=VALUE`** (required for every parameter): one flag per `${Name}` or `$[Name]` in the template. - Checkbox params (`$[Name]`): use `true`/`false` (also `1`/`0`, `yes`/`no`). - If any text `${Name}` is missing or empty, or a `$[Name]` is omitted / not a boolean, the command **fails**. - The GUI is not started when using the `print` subcommand. - **`posprint link`** encodes the `.pos` file as a `posprint://` URL on stdout (see [POSPRINT-URL.md](POSPRINT-URL.md)). Warns if the URL is very long. ## Examples List required parameters by opening the template in the designer, or inspect the `${...}` tokens in the file body. ```powershell posprint print C:\receipts\sale.pos -p COM3 ` --set StoreName="Corner Cafe" ` --set DocumentNumber=42 ` --set Date=2026-07-15 ` --set GrandTotal=19.99 ``` ## Printer target - Serial: **Device Manager → Ports (COM & LPT)** for the COM port; install the USB-serial driver if needed. - Bluetooth SPP: pair the printer in Windows first, then use the virtual COM port (`posprint list` labels it Bluetooth). BLE is not supported. - Spooler: use the Windows printer queue name as `-p` (same name as in Settings → Printers). - Close other programs using the same COM port before printing. ## Exit codes | Code | Meaning | |------|---------| | `0` | Printed successfully | | `1` | Error (missing parameters, parse error, port error, etc.) | ## Help ```powershell posprint print --help posprint link --help posprint --help ``` Launch the graphical designer by running `posprint` with **no** subcommand. Opening a `posprint://…` URL (from a browser) or `posprint --print` starts print-only mode: live preview on the left, parameters and printer on the right.