Admin
d6e2a8483c
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
62 lines
2.4 KiB
Markdown
62 lines
2.4 KiB
Markdown
# 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`
|
|
- signed updater artifacts when the persistent Tauri signing key is available
|
|
- `downloads/latest.json` for the signed Tauri updater
|
|
- `downloads/release.json` as the stable installer/version feed
|
|
|
|
The workflow publishes them to the Gitea release matching the version in `package.json`.
|
|
The desktop app uses the signed Tauri updater where supported and falls back to
|
|
`release.json` for installer-based upgrades such as Debian packages.
|
|
|
|
## Local build
|
|
|
|
```bash
|
|
npm install
|
|
npm run build
|
|
npm run bundle:deb
|
|
```
|
|
|
|
Windows cross-build:
|
|
|
|
```bash
|
|
cargo install --locked cargo-xwin
|
|
npm run bundle:windows
|
|
```
|
|
|
|
## Linux install script
|
|
|
|
Download and run the checked installer:
|
|
|
|
```bash
|
|
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.
|