Skip to content

Repository files navigation

ARCWorks Simple Receipt Printer

Current release: 1.0.1

ARCWorks Simple Receipt Printer

A small Windows receipt-printing application for printing a delivery receipt in any selected position of a four-up 216 x 279 mm sheet. It does not require Microsoft Word, a POS system, a database, or an internet connection.

Download

Download the tested Windows installer from the latest GitHub release. Windows may display an Unknown publisher warning because the installer is not digitally code-signed.

Phase 1 features

  • Native Windows GUI and printer support
  • 216 x 279 mm portrait sheet divided into four receipt positions
  • Select top-left, top-right, bottom-left, bottom-right, or any combination
  • Live full-sheet preview
  • Native print preview and printer selection
  • Seven editable product rows with calculated amounts and total
  • Cash, 7-day, 14-day, and custom terms
  • Sequential receipt numbers stored locally
  • Printed receipts saved as readable JSON records
  • Receipt layouts stored as reusable JSON templates
  • Import reusable receipt-template JSON files from the GUI
  • Upload a signature image and optionally place it on the receipt
  • Installed-printer selector with ready/unavailable status
  • No customer or receipt database

Build

Requires the .NET 10 SDK on the development computer:

dotnet build -c Release

Run the regression tests with:

dotnet test tests\ARCWorksSimpleReceiptPrinter.Tests\ARCWorksSimpleReceiptPrinter.Tests.csproj -c Release

Create a self-contained Windows build

dotnet publish -c Release -r win-x64 --self-contained true -p:PublishSingleFile=true -o publish/win-x64

The published executable does not require .NET or Microsoft Word on the destination computer.

Windows installer

Compile Installer\ARCWorksSimpleReceiptPrinter.iss with Inno Setup 6 after publishing the win-x64 build. The installer is per-user, does not require administrator access, adds a Start Menu shortcut, and offers an optional desktop shortcut.

Templates and saved receipts

On first launch, bundled templates are copied to:

%LOCALAPPDATA%\ARCWorksSimpleReceiptPrinter\Templates

Copy and rename a JSON template to create another receipt format. The Open Templates button opens this folder.

Saved receipt records are written to:

Documents\ARCWorks Simple Receipt Printer\Receipts

Printing notes

  • Select 216 x 279 mm, Letter, or Short paper in the printer driver.
  • Print at actual size / 100 percent.
  • Disable fit-to-page scaling.
  • Printer hardware margins vary, so test one sheet before using pre-cut or partially used paper.
  • The on-screen dashed cutting guides are preview-only and are never sent to the printer.
  • Printing compensates for the selected printer's reported hardware-margin offset and keeps content within an approximately 9 mm safe page inset.

Privacy

The application works offline. Business identity is stored in Templates/*.json; the template model's compiled defaults are intentionally blank. Review bundled templates before publishing a fork or sharing a customized build.

License

Released under the MIT License.

About

Simple four-up delivery receipt printing for Windows

Topics

Resources

Stars

1 star

Watchers

0 watching

Forks

Releases

Packages

Contributors

Languages