Skip to content
dharantej1Public

About

Self-service print kiosk system for print shops and campuses. Scan a QR code, upload PDFs or images from your phone, pay via Razorpay UPI, and enter a 6-digit OTP to print.

Topics

Resources

Stars

1 star

Watchers

0 watching

Forks

Latest commit

 

History

42 Commits

Folders and files

Repository files navigation

JetPrint Kiosk Icon: modern instant print kiosk icon

JetPrint

The self-service print kiosk system; an open-source, modern touch kiosk and mobile cloud relay.
Scan, upload from any mobile browser, pay via Razorpay UPI, and release prints via 6-digit OTP in seconds.
macOS · Windows · Linux · Raspberry Pi ARM64 · Mobile Web

License: AGPL-3.0 Written in Rust Frontend: React & TypeScript Cloud Relay: Node.js Payments: Razorpay UPI Platforms: macOS, Windows, Linux, Raspberry Pi Local-First Storage

Sponsor on GitHub    Donate with PayPal    Buy Me A Coffee

Highlights · How it works · Mobile · Kiosk · Raspberry Pi · Security · Architecture · Get started · Downloads · Documentation · Support


Note

JetPrint transforms any standard USB or network printer into an autonomous, self-service print station. Designed for copy centers, universities, libraries, and coworking spaces. Customers require zero app downloads or accounts, payments settle instantly through UPI, and print jobs remain stored locally on your kiosk hardware.


Highlights

Instant & Contactless

Customers point their phone camera at the on-screen QR code, upload documents directly in Safari or Chrome, preview exact page counts and costs, and pay with any UPI app (GPay, PhonePe, Paytm). The instant 6-digit OTP releases their pages at the kiosk.

Appliance-Grade Resilient

Written in pure Rust on Tauri v2 with local SQLite, native CUPS and Windows spooler integration, and automated WebSocket reconnect loops. Runs 24/7 on hardware ranging from high-end PCs to a $35 Raspberry Pi 4/5 with unattended boot-to-kiosk support.

Private & Yours

GNU AGPL v3 licensed with zero cloud lock-in. Print files download straight to your kiosk storage (~/Documents/JetPrint KIOSK) and are automatically deleted after 48 hours. Kiosk settings are protected by Argon2id passwords and a 12-word BIP-39 recovery seed phrase.


How it works

JetPrint bridges the physical printer, the kiosk screen, and the customer's phone through a lightweight, resilient event loop:

  ┌─────────────────────────┐
  │ Customer Mobile Browser │
  └───────────┬─────────────┘
              │  1. Scans on-screen QR code (GET /upload?machine_id=<id>)
              │  2. Uploads PDFs or Images (page counts via pdf-lib)
              │  3. Pays via Razorpay UPI (or simulated Dev Mode)
              ▼
  ┌─────────────────────────┐
  │   Cloud Relay Server    │
  └───────────┬─────────────┘
              │  4. Verifies HMAC-SHA256 signature, generates 6-digit OTP
              │  5. Dispatches job over secure WebSocket (/ws)
              ▼
  ┌─────────────────────────┐
  │ Tauri v2 Desktop Kiosk  │  ◄── Downloads files to ~/Documents/JetPrint KIOSK/
  └───────────┬─────────────┘  ◄── Inserts job + OTP into local SQLite (jetprint.db)
              │
              │  6. Customer types OTP on touch keypad (or Owner prints from queue)
              ▼
  ┌─────────────────────────┐
  │  OS Print Spooler / CUPS│ ──► Physical Printer
  └─────────────────────────┘

Scan, upload & pay in seconds

Customers never need to download an application, join a local Wi-Fi network, or register an account.

  • Zero App Footprint: The mobile web app (cloud-relay/public/) opens in any modern smartphone browser immediately upon scanning the kiosk's dynamic QR code.
  • Accurate Pre-flight Page Analysis: Server-side PDF analysis using pdf-lib extracts exact page counts and orientation before charging, eliminating pricing surprises.
  • Dynamic Per-Page Pricing: Pricing syncs in real-time from the kiosk's local settings (B&W per-page, Color per-page, and custom shop branding).
  • Direct UPI & Razorpay Checkout: Integrates seamlessly with Razorpay UPI payment gateway; webhook endpoints verify transactions using HMAC-SHA256 signatures before generating print tickets.
  • Built-in Dev Mode: When Razorpay credentials are not configured, JetPrint automatically runs in sandbox simulation mode so you can test complete end-to-end printing flows for free.

Seamless Mobile Experience

  1. Camera scan: Customer scans the dynamic machine QR code.
  2. Document upload: Drag & drop or select PDFs, PNGs, and JPEGs.
  3. Print options: Choose copies, Black & White, or Color.
  4. Pay: Tap to trigger phone UPI intent or scan payment QR.
  5. Get OTP: Instant display of the 6-digit release code.
# Verify payment and status via the Cloud Relay API
curl -s http://localhost:3000/api/machines/kiosk_01
curl -s http://localhost:3000/api/jobs/job_9481/status

# JSON Response:
# {
#   "status": "paid",
#   "otp": "482910",
#   "amount_paise": 400,
#   "pages": 2
# }

Kiosk: Self-Service & Owner Modes

JetPrint features a dual-mode interface designed for high-throughput public spaces and straightforward shop administration:

1. Self-Service Mode

  • High-Contrast QR Display: Shows the real-time Cloud Relay connection state and machine ID.
  • Touch-Friendly Keypad: Large numeric keypad designed for responsive touchscreens and all-in-one POS displays.
  • Audio & Visual Feedback: Clear error messaging for expired or invalid OTP codes, with instant printing status spinners.

2. Owner Mode (Password Protected)

  • Live Print Queue: View all incoming, paid, printing, and completed jobs with timestamps and revenue.
  • Date Filtering: Quick filter by date range to audit today's print volume and total income.
  • Manual Overrides: Reprint failed sheets or manually delete corrupted jobs with one click.
  • In-App Logs: Direct access to live diagnostic logs for immediate troubleshooting.

Display & Tamper Protection

The kiosk launches in centered windowed mode by default and features a dedicated Fullscreen Toggle (or F11 / Esc) locked behind the Owner Password. When deployed in public areas, customers cannot minimize, resize, or exit the kiosk interface without administrative credentials.


Turn a $35 Raspberry Pi into a print appliance

JetPrint provides native ARM64 Linux builds (linux-aarch64), enabling you to deploy a fully autonomous print kiosk on low-cost single-board hardware like a Raspberry Pi 4 or Raspberry Pi 5.

# 1. Install runtime dependencies & JetPrint on Raspberry Pi OS 64-bit
sudo apt update
sudo apt install -y libwebkit2gtk-4.1-0 libcups2 libappindicator3-1 librsvg2-2
sudo apt install ./JetPrint_*_arm64.deb

# 2. Add your printer in CUPS (http://localhost:631)
# JetPrint automatically detects default and network printers managed by CUPS

# 3. Enable unattended boot-to-kiosk in systemd or autostart
mkdir -p ~/.config/autostart
cat << 'EOF' > ~/.config/autostart/jetprint.desktop
[Desktop Entry]
Type=Application
Name=JetPrint Kiosk
Exec=/usr/bin/jetprint
X-GNOME-Autostart-enabled=true
EOF

CUPS handles raw spooling to thermal receipt printers, laser office printers, and industrial multi-function copiers over USB or IPP.


Security, recovery & local storage

Local-First Storage Directory

JetPrint stores all local state in the user's standard documents folder (~/Documents/JetPrint KIOSK):

  • jetprint.db: High-performance SQLite database tracking jobs, configuration, and audit logs.
  • jobs/: Local copies of downloaded PDFs and images queued for physical printing.
  • logs/jetprint.log: Rolling diagnostic log file capturing system, printer, and WebSocket events.
  • Automated 48-Hour Cleanup: Background worker automatically purges cached print files older than 48 hours to prevent storage exhaustion and protect user privacy.

Cryptographic Security & Reset

  • Argon2id Password Protection: Owner credentials are never stored in plaintext; all administrative verification uses high-memory Argon2id hashing.
  • BIP-39 12-Word Seed Phrase: Upon first initialization, the setup wizard generates a standardized 12-word cryptographic seed phrase. If an owner forgets their password, they can reset it instantly without database surgery or data loss.
  • State Migration & Resilience: Reinstalling JetPrint automatically detects existing kiosk data, prompting you to Keep Previous Data or Start Fresh.

Multi-platform native engine & auto-updater

JetPrint is built on Tauri v2, combining a lightweight, secure Rust core with a responsive React frontend:

  • Ultra-Low Memory Footprint: Idles at ~35–50 MB RAM, compared to 500+ MB for Electron equivalents.
  • Cryptographically Signed Auto-Updates: In-app updates are verified against a Minisign public key and downloaded directly from GitHub Releases.
  • Dual-Path Update Resolution: Employs an intelligent fallback resolver: if the primary manifest mirror is slow, it automatically queries GitHub Releases API with strict connect timeouts.
  • Automated Matrix CI: Every release candidate is compiled and packaged across 15 matrix targets including macOS Apple Silicon (aarch64), macOS Intel (x86_64), Windows (x64 NSIS & MSI), Linux x86_64, and Raspberry Pi ARM64.

How it's built

JetPrint is organized as a modular repository separating the cloud relay facade from the native desktop kiosk:

Component Path Tech Stack Responsibility
Cloud Relay cloud-relay/ Node.js, Express, ws, pdf-lib, Razorpay Serves mobile upload UI, counts PDF pages, manages UPI orders, verifies webhooks, pushes OTPs over WebSocket.
Kiosk Core (Rust) desktop-kiosk/src-tauri/ Tauri v2, rusqlite, printers, argon2, bip39, tokio Native OS printer spooling (CUPS & WinSpool), SQLite storage, WebSocket client, 48h file cleanup, and Minisign updater.
Kiosk UI (React) desktop-kiosk/src/ React 18, TypeScript, Vite, Tailwind Self-Service touch keypad, QR display, Owner Mode print queue, date filters, first-run wizard, and settings modal.
Release Pipeline .github/workflows/ GitHub Actions, Tauri Action, Minisign Multi-platform build matrix, artifact signing, and unified latest.json updater manifest consolidation.

Get started

Prerequisites

  • Node.js 20+ and npm
  • Rust stable (1.78+) and cargo
  • Native OS Build Tools:
    • macOS: xcode-select --install
    • Windows: Microsoft C++ Build Tools & WebView2
    • Linux / Raspberry Pi:
      sudo apt-get update
      sudo apt-get install -y libwebkit2gtk-4.1-dev libappindicator3-dev librsvg2-dev patchelf libcups2-dev

1. Launch Cloud Relay

cd cloud-relay
cp .env.example .env
npm install
npm run dev

Runs on http://localhost:3000. Leave RAZORPAY_KEY_ID and RAZORPAY_KEY_SECRET blank to use simulated payment mode.

2. Launch Desktop Kiosk

cd desktop-kiosk
npm install

# Option A: Run Vite UI only (browser preview at http://localhost:5173)
npm run dev

# Option B: Run full native desktop app with Rust backend
npx tauri dev

Tip

Mobile QR Testing on Local Wi-Fi: To test mobile scanning from a physical phone on the same Wi-Fi network, open Owner Settings on the kiosk and change Cloud Relay URL to your computer's LAN IP address (e.g. http://192.168.1.50:3000).


Downloads

Download production-ready installers from the GitHub Releases page.

Operating System Architecture Package Format Notes
macOS Apple Silicon (M1–M4) JetPrint_<ver>_aarch64.dmg Signed .dmg installer
macOS Intel (x86_64) JetPrint_<ver>_x64.dmg Signed .dmg installer
Windows 64-bit (x64) JetPrint_<ver>_x64-setup.exe Standard NSIS installer
Windows 64-bit (x64) JetPrint_<ver>_x64.msi Enterprise MSI deployment package
Linux x86_64 JetPrint_<ver>_amd64.deb Ubuntu, Debian, Mint
Linux x86_64 JetPrint_<ver>_amd64.AppImage Portable universal binary
Raspberry Pi ARM64 (aarch64) JetPrint_<ver>_arm64.deb Raspberry Pi OS 64-bit, Ubuntu ARM64
Raspberry Pi ARM64 (aarch64) JetPrint_<ver>_arm64.AppImage Portable ARM64 binary

Documentation

Detailed technical and operational manuals are available in the repository:

  • 📖 Owner Setup Guide — Step-by-step kiosk setup for store managers, hardware recommendations, pricing configuration, CUPS/Windows printer pairing, and password recovery.
  • 🛠️ Developer Documentation — Technical reference: WebSocket wire protocol, REST API specs, SQLite database schema, Tauri IPC commands, and release pipelines.
  • 🔐 Tauri Auto-Updater Guide — Minisign cryptographic keypair generation and GitHub Actions secrets configuration.

Support

If you find JetPrint helpful and want to support ongoing development, hardware testing (Raspberry Pi setups, printer spoolers), and maintenance, consider buying a coffee or donating via PayPal:

Sponsor on GitHub    Donate with PayPal    Buy Me A Coffee

Cards: Visa, Mastercard, Amex, Discover

GitHub Sponsors: github.com/sponsors/dharantej1 · PayPal: paypal.me/dharantej1 · Buy Me a Coffee: buymeacoffee.com/pusthakalaw


License and credits

JetPrint is free and open-source software licensed under the GNU Affero General Public License v3.0 (AGPL-3.0).

Built with passion for independent print shops, students, and open-source communities.

About

Self-service print kiosk system for print shops and campuses. Scan a QR code, upload PDFs or images from your phone, pay via Razorpay UPI, and enter a 6-digit OTP to print.

Topics

Resources

Stars

1 star

Watchers

0 watching

Forks

Releases

Sponsor this project

Packages

Contributors

Languages