100% Free & Open-Source Autonomous Cloud Print Station

Turn Any Printer Into A
Self-Service Autonomous Kiosk

Printr removes the queue from Xerox and print shops. Customers scan your counter QR, upload documents from their phone, configure copies, colour, paper size and duplex, pay with a dynamic UPI QR, and your physical printer dispatches the job in seconds on Windows, macOS or Linux.

Universal Print Agent Daemon — Windows / macOS / Linux

$ git clone https://github.com/ruthwwikreddy/printr.git && cd printr && npm run agent

[10:30:01] Initializing Universal Hardware Print Daemon...

[10:30:02] Detected Physical Printers: HP_DeskJet_3540, Canon_LBP2900, Epson_L3150

[10:30:15] ORDER #PRN-9402: Payment Verified (INR 12.00) via UPI

[10:30:16] Dispatched 6 pages [A4 MONOCHROME DUPLEX] → Canon_LBP2900

✓ Print Job Completed. Ready for counter pickup.

< 2 sec
Cloud-to-printer dispatch latency
0%
Platform fee — UPI goes straight to the shop
Zero-staff
Fully automated upload → pay → print
MIT
Free forever, self-hosted, no lock-in
END-TO-END AUTONOMOUS FLOW

How Printr Works in Your Shop

Four steps for the customer, zero steps for the shop owner.

1

Customer Scans Standee

The phone camera opens your kiosk instantly. No app download, no signup, no account.

2

Upload & Configure

PDF, JPG or PNG up to 50MB. Pages are counted automatically; copies, colour, A4/A3, duplex and page range are selected on the phone.

3

Dynamic UPI QR Payment

The total is priced live from your rate card, and a UPI QR for that exact amount is generated against your own VPA.

4

Automatic Physical Print

The counter agent picks up the paid job, downloads the file and prints it natively — the customer just collects the pages.

ENGINEERED FOR MODERN XEROX CENTERS

Everything You Need To Run An Autonomous Shop

Replace pendrive transfers, WhatsApp file chaos and handwritten payment notebooks.

100% Direct UPI Payments

Dynamic UPI QR per order. Money lands in the shop owner’s bank VPA instantly — zero platform commission, no gateway onboarding, no settlement delay.

Universal Counter Agent

A single Node.js daemon on the counter PC auto-discovers USB and network printers and executes native print jobs on Windows, macOS, Linux and Raspberry Pi.

Shop Owner Control Center

Password-protected /admin with live revenue, print queue, per-page rate editor, UPI setup, agent status and one-click job retry or cancel.

Printable Counter Standee

Generate an A4 standee with your shop name, rates, 3-step instructions and a QR code that opens the kiosk on any phone camera. Print it and you are live.

Automatic Page Counting

Server-side pdf-lib inspection counts pages on upload and honours custom page ranges like 1-4,8 so pricing is exact before the customer pays.

Real-Time Job Status

Firestore listeners with an HTTP polling fallback stream every state change — awaiting payment, queued, dispatched, printing, completed or failed.

Sub-2-Second Dispatch

The agent long-polls for paid jobs, so a document reaches the physical tray seconds after the customer’s UPI app confirms the payment.

Privacy-First Retention

Uploaded documents live only as long as they need to. The cleanup route purges files older than 24 hours and blanks their stored paths.

Open-Source & Self-Hosted

MIT licensed. Your code, your domain, your data, your printer. Deploy to Vercel, Netlify, a VPS or an offline LAN box in the shop itself.

OPEN ARCHITECTURE

A Stack You Can Read In An Afternoon

Three routes, one flat-file database, an optional Firestore layer and a single agent script. Nothing hidden, nothing proprietary.

Next.js 14 App RouterWeb hub, kiosk UI, API routes
TypeScript + React 18Typed, component-driven front end
Cloud FirestoreOptional real-time order + settings sync
pdf-libServer-side PDF page counting
Node.js agentNative printing via CUPS / PowerShell
UPI deep linksDynamic QR payment intents
/This open-source showcase on printr.ruthwikreddy.live — the customer kiosk on every self-hosted deployment.
/appThe customer self-service kiosk: upload, configure, pay, watch live print status.
/adminPassword-protected shop control center: revenue, queue, rates, agent setup, QR standee.
CROSS-PLATFORM PRINTER COMPATIBILITY

Works on Any Computer & Any Printer

The Printr agent drives the native print pipeline of each operating system.

Windows 10 / 11 / Server

Prints through PowerShell Start-Process -Verb PrintTo with a SumatraPDF and Out-Printer fallback. Ships a double-click launcher: start-windows.bat.

set BACKEND_URL=https://print.yourshop.com && node print-agent\agent.js

macOS, Linux & Raspberry Pi (CUPS)

Uses the native lp driver and maps paper size, colour model, duplex binding and page ranges to CUPS options automatically.

BACKEND_URL="https://print.yourshop.com" ./print-agent/start-mac-linux.sh
Compatible with all major brands:
HP LaserJet / DeskJet / InkTankCanon LBP / PIXMA / imageCLASSEpson EcoTank L-SeriesBrother HL / DCP / MFCXerox & Ricoh Heavy Duty
SELF-HOST IN UNDER 5 MINUTES

Deploy Printr On Your Own Domain

Every step, in order — from clone to a live counter standee.

1

Clone and install

Node.js 18+ is the only prerequisite. Run it locally first to confirm the kiosk and admin load.

git clone https://github.com/ruthwwikreddy/printr.git && cd printr && npm install && npm run dev
2

Deploy the hub to Vercel, Netlify or a VPS

Import the repo, keep the Next.js preset, then set ADMIN_PASSWORD, PRINT_AGENT_AUTH_SECRET and (optionally) the NEXT_PUBLIC_FIREBASE_* variables. Attach your domain, e.g. print.yourshop.com.

ADMIN_PASSWORD=your-strong-password PRINT_AGENT_AUTH_SECRET=32+random-characters
3

Configure your shop in /admin

Sign in with your admin password and set the shop name, tagline, address, counter phone, UPI VPA and per-page rates for A4/A3 in black & white and colour.

4

Start the agent on the counter PC

Point BACKEND_URL at your deployed hub. Use PM2 to keep it alive across reboots so the shop never misses a job.

npm install -g pm2 && pm2 start ecosystem.config.js && pm2 save && pm2 startup
5

Print and place your QR standee

In /admin open Counter QR Standee, print it on A4, and place it on the counter. Customers are now self-service.

QUESTIONS, ANSWERED

Frequently Asked Questions

Everything shop owners and self-hosters ask before switching on Printr.

Yes. Printr is MIT licensed and hosted on GitHub. You can fork it, rebrand it, sell services around it and run it for as many shops as you like without paying anyone.

CREATOR

Ruthwik Reddy

Printr is designed and engineered by Ruthwik Reddy, an engineer building open-source automation for real-world small businesses. Printr is released free under the MIT License so any print shop, campus or office anywhere can run an autonomous printing counter without paying software rent.

Ready to make your counter autonomous?

Clone it, deploy it, print your standee. It costs nothing but a domain.