QR Print Station is a self-hosted print intake system built for small print shops. Customers scan a QR code, upload their documents, choose color mode, paper size, and print style per file, then submit the order — all from their phone or laptop. Staff manage the full order lifecycle from a secret admin dashboard.Documentation Index
Fetch the complete documentation index at: https://mintlify.com/hxmz-axfn07/qr-printing-sfw/llms.txt
Use this file to discover all available pages before exploring further.
Quickstart
Install dependencies, configure your environment, and run your first order in minutes.
Configuration
Customize shop info, pricing, paper sizes, and theme colors via config.yml and .env.
Admin Dashboard
Manage orders through the full lifecycle from new to printed with the secret admin URL.
API Reference
Explore every HTTP endpoint for order creation, transitions, file serving, and config.
How it works
QR Print Station runs a Python HTTP server on your local network. A generated QR code points customers directly to the upload form. When a customer submits an order, it lands in the admin dashboard where staff can review, approve, and print.Install and configure
Clone the repo, install Python dependencies, set up MySQL, and edit
.env with your database credentials and admin token.Start the server
Run
.venv/bin/python server.py. The server starts on port 8000 and auto-generates a QR code PNG pointing to the upload URL.Customers scan and upload
Customers scan the QR, fill in their name and phone, add files with print options, and submit their order.
Key features
QR Code Generation
Auto-generates a QR code PNG that refreshes whenever your public URL changes. Works with ngrok for remote access.
Multi-Document Cart
Customers can add multiple files in a single order, each with independent color, paper size, style, and copy settings.
Automatic Cost Estimates
PDF page counts are detected on upload. Costs are estimated immediately using your pricing table.
Order Lifecycle
Orders move through new → reviewing → ready → printing → printed with staff controls at each step.
Secret Admin URL
The dashboard is protected by a secret token in the URL — no login page, no session cookies required.
Fully Customizable
Edit shop name, pricing, paper sizes, color mode labels, and theme accent colors in config.yml.
QR Print Station is designed to run on a trusted local network. There is no login page — the admin dashboard is protected by a secret token embedded directly in the URL (
/admin/<ADMIN_TOKEN>). Set a strong ADMIN_TOKEN in .env, keep it secret, and rotate it if exposed.