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
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.
|
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. |
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. |
GNU AGPL v3 licensed with zero cloud lock-in. Print files download straight to your kiosk storage ( |
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
└─────────────────────────┘
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-libextracts 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.
|
# 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
# } |
JetPrint features a dual-mode interface designed for high-throughput public spaces and straightforward shop administration:
|
|
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.
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
EOFCUPS handles raw spooling to thermal receipt printers, laser office printers, and industrial multi-function copiers over USB or IPP.
|
JetPrint stores all local state in the user's standard documents folder (
|
|
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 (x64NSIS & MSI), Linux x86_64, and Raspberry Pi ARM64.
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. |
- 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
- macOS:
cd cloud-relay
cp .env.example .env
npm install
npm run devRuns on http://localhost:3000. Leave RAZORPAY_KEY_ID and RAZORPAY_KEY_SECRET blank to use simulated payment mode.
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 devTip
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).
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 |
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.
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:
GitHub Sponsors: github.com/sponsors/dharantej1 · PayPal: paypal.me/dharantej1 · Buy Me a Coffee: buymeacoffee.com/pusthakalaw
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.