BlueGit

timfa posprint

Files

posprint
README.md

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, or USB-serial).

Target platforms: Windows and Linux (x64).

Status

v0.2.1 — Rust + egui app with editor, preview, help, .pos files, parameters, and multi-transport printing.

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

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

# Linux
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
Windowsposprint.exeDownload from GitLab release job artifacts

Tag a version (e.g. 0.2.0) to trigger release builds.

Features

  • Markdown-like template editor with live preview (Design tab)
  • Page width (mm) and calibrated preview zoom
  • Save and load .pos files
  • Parameter tokens (${DocumentNumber}) with print dialog and CLI --set
  • Bullet lists, headings, @date / @time, barcodes, QR, images
  • Print via USB-direct, Windows spooler, or serial (baud probed)
  • 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
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 / cli-help

ESC/POS encoding is implemented in-tree.