# Command-line printing (Linux) Print a `.pos` template without opening the GUI. Run `posprint cli-help` to print this section from the binary (no GUI required). ## Syntax ```bash posprint print --printer --set Name=Value [--set Other=Value ...] ``` Short form: ```bash posprint print receipt.pos -p /dev/ttyUSB0 --set StoreName="My Shop" --set DocumentNumber=1001 ``` ## Rules - **`--printer` / `-p`** (required): serial device path (e.g. `/dev/ttyUSB0`, `/dev/ttyACM0`), or another printer id accepted by discovery. - **`--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. ## Permissions Your user must be in the **`dialout`** group: ```bash sudo usermod -aG dialout "$USER" # log out and back in groups ``` ## Examples ```bash posprint print ~/receipts/sale.pos -p /dev/ttyUSB0 \ --set StoreName="Corner Cafe" \ --set DocumentNumber=42 \ --set Date=2026-07-15 \ --set GrandTotal=19.99 ``` ## Printer device ```bash ls -l /dev/ttyUSB* /dev/ttyACM* 2>/dev/null ``` Use the device node shown when the printer is connected. ## Exit codes | Code | Meaning | |------|---------| | `0` | Printed successfully | | `1` | Error (missing parameters, parse error, permission denied, etc.) | ## Help ```bash posprint print --help posprint --help ``` Launch the graphical designer by running `posprint` with **no** subcommand.