fieldlens-desktop/README.md
Admin d4975836b9
Some checks failed
Desktop Release / Bootstrap updater signing key (push) Has been cancelled
Desktop Release / Windows x64 NSIS (push) Has been cancelled
Desktop Release / Linux x64 DEB + AppImage (push) Has been cancelled
Desktop Release / Publish public desktop release (push) Has been cancelled
fix: finalize printer queue setup for 0.1.2
2026-09-24 00:00:29 +00:00

2.1 KiB

FieldLens Desktop

Public build and release mirror for FieldLens Print.

The private Admin/fieldlens repository remains the source of truth. This repository contains only the desktop client needed to build public Windows and Linux installers.

Releases

A push to main builds:

  • fieldlens-print-windows-x64-setup.exe
  • fieldlens-print-linux-x64.deb

The workflow publishes them to the Gitea release matching the version in package.json.

Local build

npm install
npm run build
npm run bundle:deb

Windows cross-build:

cargo install --locked cargo-xwin
npm run bundle:windows

Linux install script

Download and run the checked installer:

curl -fsSL https://fieldlens.arrowstack.dev/downloads/install.sh | sh

The script supports x86_64/amd64 Debian/Ubuntu-style systems, downloads the public .deb, verifies its SHA-256, then installs it with the system package manager.

Printer queue setup

FieldLens Print can create an OS printer queue that appears in normal application print dialogs.

  1. Open FieldLens Print.
  2. Choose the installed physical printer under Forward to installed printer.
  3. For network printers, FieldLens detects the RAW/TCP endpoint when the OS exposes it. Otherwise enter the printer address manually as host:9100.
  4. Click Create / repair FieldLens Print and approve the Windows UAC / Linux CUPS elevation prompt.
  5. Start RAW capture.
  6. In the source application, print to FieldLens Print.

Windows creates the virtual queue with the selected destination printer's existing driver and points it at 127.0.0.1:9100, so the captured stream is already in the destination printer's language before FieldLens inspects and forwards it.

Linux creates a CUPS raw queue named FieldLens-Print with display name FieldLens Print and routes it to the same local RAW listener.

USB/shared queues may not expose a RAW/TCP address. In that case the installed-printer selector still supplies the driver for the virtual Windows queue, while the physical destination address must be entered manually.