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)
| Platform | Artifact | Install |
|---|---|---|
| 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 |
| Windows | posprint.exe | Download 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
.posfiles - 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
| Document | Description |
|---|---|
| HELP.md | User reference (mirrored in-app Help tab) |
| ARCHITECTURE.md | System architecture and module breakdown |
| DSL-SPEC.md | Document markup language (.pos body syntax) |
| FILE-FORMAT.md | .pos file envelope (metadata + body) |
| PRINTING.md | Printer discovery, transport, ESC/POS pipeline |
| POSPRINT-URL.md | posprint:// deep links and lib/ helpers |
| AUR.md | AUR package layout, secrets, and tag-driven publishing |
| BUILD.md | Local build scripts and Linux package formats |
Documentation must stay aligned with the codebase; see .cursor/rules/documentation.mdc.
Dependencies (minimal)
| Crate | Why |
|---|---|
eframe / egui | Native UI |
serde / serde_json | .pos file format |
serialport | Serial printer I/O |
rusb | USB printer-class devices |
image | Load PNG/JPEG for @image |
rfd | Native open/save dialogs |
barcoders | Raster barcode rendering |
qrcode | Raster QR rendering |
clap | CLI print / link / cli-help |
flate2 / base64 | posprint:// URL payload |
ureq | Download @image http(s)://… |
ESC/POS encoding is implemented in-tree.