BlueGit

timfa posprint

Files

posprint / README.md

README.md

feat: include paired Classic Bluetooth SPP printers in discovery
timfa project_84475926_bot_3b4fb417c41b9b24a7422b6452f025d2 · pushed by timfa · 8 weeks ago
8b514b7f History
README.md 4.0 KiB Download Raw

posprint

Cross-platform designer for POS (point-of-sale) receipt documents. Edit templates in a markdown-like syntax, preview output live, substitute runtime parameters, and print via raw ESC/POS (USB printer-class, Windows spooler, USB-serial, or Classic Bluetooth SPP after OS pairing).

Target platforms: Windows and Linux (x64).

Status

v0.5.6 — Drop noconfirm trust/referrer verify; QR/barcode URLs with query strings; skip TLS checks for @image downloads.

Build and run

Requires Rust 1.88+ (rustup or pacman -S rust on Arch). See docs/BUILD.md for OS libraries and package scripts.

cargo test          # unit tests
cargo run           # launch the designer
cargo build --release

Scripts: scripts/build-windows.ps1, scripts/build-linux.sh, scripts/build-arch.sh (Interactive shells offer to install missing dependencies.)

Command-line printing

# List discovered printers (USB, spooler, serial, paired Bluetooth SPP)
posprint list

# Windows (serial, Bluetooth COM after pairing, or spooler queue name)
posprint print receipt.pos -p COM3 --set StoreName="Shop" --set DocumentNumber=42

# Linux (USB-serial or RFCOMM after pairing)
posprint print receipt.pos -p /dev/ttyUSB0 --set StoreName="Shop" --set DocumentNumber=42

# Embedded CLI help for this OS
posprint cli-help

All ${Parameters} must be supplied via --set NAME=VALUE or the command fails.

Linux serial: add your user to the dialout group.

Releases (GitLab CI)

PlatformArtifactInstall
Linux (Debian/Ubuntu).deb (amd64)sudo dpkg -i posprint_*_amd64.deb then sudo apt-get install -f
Linux (Arch).pkg.tar.zst (x86_64)sudo pacman -U posprint_*_x86_64.pkg.tar.zst or AUR posprint / posprint-bin
Windowsposprint.exeDownload from GitLab release job artifacts

Tag a version (e.g. 0.4.0) to trigger release builds. If AUR publishing is configured, the same tag pipeline also updates the posprint and posprint-bin AUR packages.

Features

  • Markdown-like template editor with live preview (Design tab)
  • Page width (mm) and calibrated preview zoom
  • Save and load .pos files
  • Parameter tokens: ${Name} (text) and $[Name] (bool checkbox) via print dialog and CLI --set
  • Inline ASCII checkboxes ([] / [ ] / [x]) — CP437-safe on thermal printers
  • Nested bullet lists, headings, @date / @time, barcodes, QR, images
  • Print via USB-direct, Windows spooler, USB-serial, or paired Classic Bluetooth SPP (baud probed; BLE not supported)
  • In-app Help tab (from docs/HELP.md)

Documentation

DocumentDescription
HELP.mdUser reference (mirrored in-app Help tab)
ARCHITECTURE.mdSystem architecture and module breakdown
DSL-SPEC.mdDocument markup language (.pos body syntax)
FILE-FORMAT.md.pos file envelope (metadata + body)
PRINTING.mdPrinter discovery, transport, ESC/POS pipeline
POSPRINT-URL.mdposprint:// deep links and lib/ helpers
AUR.mdAUR package layout, secrets, and tag-driven publishing
BUILD.mdLocal build scripts and Linux package formats

Documentation must stay aligned with the codebase; see .cursor/rules/documentation.mdc.

Dependencies (minimal)

CrateWhy
eframe / eguiNative UI
serde / serde_json.pos file format
serialportSerial printer I/O
rusbUSB printer-class devices
imageLoad PNG/JPEG for @image
rfdNative open/save dialogs
barcodersRaster barcode rendering
qrcodeRaster QR rendering
clapCLI print / link / cli-help
flate2 / base64posprint:// URL payload
ureqDownload @image http(s)://…

ESC/POS encoding is implemented in-tree.

Source
1# posprint
2
3Cross-platform designer for POS (point-of-sale) receipt documents. Edit templates in a markdown-like syntax, preview output live, substitute runtime parameters, and print via raw ESC/POS (USB printer-class, Windows spooler, USB-serial, or Classic Bluetooth SPP after OS pairing).
4
5**Target platforms:** Windows and Linux (x64).
6
7## Status
8
9**v0.5.6** — Drop noconfirm trust/referrer verify; QR/barcode URLs with query strings; skip TLS checks for `@image` downloads.
10
11## Build and run
12
13Requires **Rust 1.88+** ([rustup](https://rustup.rs/) or `pacman -S rust` on Arch). See [docs/BUILD.md](docs/BUILD.md) for OS libraries and package scripts.
14
15```bash
16cargo test # unit tests
17cargo run # launch the designer
18cargo build --release
19```
20
21**Scripts:** `scripts/build-windows.ps1`, `scripts/build-linux.sh`, `scripts/build-arch.sh`
22(Interactive shells offer to install missing dependencies.)
23
24### Command-line printing
25
26```bash
27# List discovered printers (USB, spooler, serial, paired Bluetooth SPP)
28posprint list
29
30# Windows (serial, Bluetooth COM after pairing, or spooler queue name)
31posprint print receipt.pos -p COM3 --set StoreName="Shop" --set DocumentNumber=42
32
33# Linux (USB-serial or RFCOMM after pairing)
34posprint print receipt.pos -p /dev/ttyUSB0 --set StoreName="Shop" --set DocumentNumber=42
35
36# Embedded CLI help for this OS
37posprint cli-help
38```
39
40All `${Parameters}` must be supplied via `--set NAME=VALUE` or the command fails.
41
42**Linux serial:** add your user to the `dialout` group.
43
44## Releases (GitLab CI)
45
46| Platform | Artifact | Install |
47|----------|----------|---------|
48| Linux (Debian/Ubuntu) | `.deb` (amd64) | `sudo dpkg -i posprint_*_amd64.deb` then `sudo apt-get install -f` |
49| Linux (Arch) | `.pkg.tar.zst` (x86_64) | `sudo pacman -U posprint_*_x86_64.pkg.tar.zst` or AUR `posprint` / `posprint-bin` |
50| Windows | `posprint.exe` | Download from GitLab release job artifacts |
51
52Tag a version (e.g. `0.4.0`) to trigger release builds. If AUR publishing is configured, the same tag pipeline also updates the `posprint` and `posprint-bin` AUR packages.
53
54## Features
55
56- Markdown-like template editor with live preview (Design tab)
57- Page width (mm) and calibrated preview zoom
58- Save and load `.pos` files
59- Parameter tokens: `${Name}` (text) and `$[Name]` (bool checkbox) via print dialog and CLI `--set`
60- Inline ASCII checkboxes (`[]` / `[ ]` / `[x]`) — CP437-safe on thermal printers
61- Nested bullet lists, headings, `@date` / `@time`, barcodes, QR, images
62- Print via USB-direct, Windows spooler, USB-serial, or paired Classic Bluetooth SPP (baud probed; BLE not supported)
63- In-app **Help** tab (from [docs/HELP.md](docs/HELP.md))
64
65## Documentation
66
67| Document | Description |
68|----------|-------------|
69| [HELP.md](docs/HELP.md) | **User reference** (mirrored in-app Help tab) |
70| [ARCHITECTURE.md](docs/ARCHITECTURE.md) | System architecture and module breakdown |
71| [DSL-SPEC.md](docs/DSL-SPEC.md) | Document markup language (`.pos` body syntax) |
72| [FILE-FORMAT.md](docs/FILE-FORMAT.md) | `.pos` file envelope (metadata + body) |
73| [PRINTING.md](docs/PRINTING.md) | Printer discovery, transport, ESC/POS pipeline |
74| [POSPRINT-URL.md](docs/POSPRINT-URL.md) | `posprint://` deep links and `lib/` helpers |
75| [AUR.md](docs/AUR.md) | AUR package layout, secrets, and tag-driven publishing |
76| [BUILD.md](docs/BUILD.md) | Local build scripts and Linux package formats |
77
78Documentation must stay aligned with the codebase; see `.cursor/rules/documentation.mdc`.
79
80## Dependencies (minimal)
81
82| Crate | Why |
83|-------|-----|
84| `eframe` / `egui` | Native UI |
85| `serde` / `serde_json` | `.pos` file format |
86| `serialport` | Serial printer I/O |
87| `rusb` | USB printer-class devices |
88| `image` | Load PNG/JPEG for `@image` |
89| `rfd` | Native open/save dialogs |
90| `barcoders` | Raster barcode rendering |
91| `qrcode` | Raster QR rendering |
92| `clap` | CLI `print` / `link` / `cli-help` |
93| `flate2` / `base64` | `posprint://` URL payload |
94| `ureq` | Download `@image http(s)://…` |
95
96ESC/POS encoding is implemented in-tree.