Print a QR code poster, table tent, card or sticker sheet
Make a print-ready PDF or PNG of a QR code poster, table tent, WiFi card, business card sheet or sticker sheet.
Input
Result
Choose a file and press Run.
Live preview, drawn in your browser. Press Run for the finished file.
Files you upload and the results are stored for one hour, then deleted. Anyone who has the link can open them, so don't upload anything private.
Use it from code or an agent
# 1. Upload the file. The reply ends with a line "ref <id>/f1": that is the file reference.
# 2. Run the tool with that reference. "wait" holds the reply for up to 30 seconds while the job runs.
curl -s https://setget.net/v1/tools/qr-print \
-H 'Content-Type: application/json' \
-d '{"input":{"text":"https://setget.net","template":"table-tent","title":"Menu","preset":"ocean","accent":"#0c4a6e"},"wait":30}'
# 3. The reply is {"tool", "ms", "result", "files": [{"name", "size", "url", "ref"}], "job"}.
# Download a result file from its "url", or pass its "ref" to another tool.
# Still running after the wait? The reply is 202 with "job": follow it with
# curl -s https://setget.net/v1/jobs/JOB_ID?wait=30
import json, urllib.parse, urllib.request
BASE = "https://setget.net"
def call(method, path, body=None, headers=None):
request = urllib.request.Request(BASE + path, body, headers or {}, method=method)
return json.load(urllib.request.urlopen(request))
def upload(path):
"""Step 1: upload a file and get its reference."""
name = path.replace("\\", "/").rsplit("/", 1)[-1]
with open(path, "rb") as handle:
reply = call("PUT", "/drop/" + urllib.parse.quote(name), handle.read(), {"Accept": "application/json"})
return reply["file"]["ref"]
# Step 2: run the tool with the reference.
body = {"input": {'text': 'https://setget.net', 'template': 'table-tent', 'title': 'Menu', 'preset': 'ocean', 'accent': '#0c4a6e'}, "wait": 30}
reply = call("POST", "/v1/tools/qr-print", json.dumps(body).encode(), {"Content-Type": "application/json"})
# Step 3: a job that is still running comes back as {"job": ...}. Wait for it.
while "result" not in reply and reply.get("job", reply).get("status") in ("queued", "running"):
reply = call("GET", "/v1/jobs/" + reply.get("job", reply)["id"] + "?wait=30")
if "error" in reply:
raise SystemExit(reply["error"]["message"])
print(reply["result"])
for file in reply["files"]: # result files: download from "url", or pass "ref" to another tool
print(file["name"], file["size"], file["url"], file["ref"])
const BASE = "https://setget.net";
// Step 1: upload a file and get its reference. file: a File or Blob
// (in Node: new Blob([fs.readFileSync(path)])).
async function upload(file, name) {
const response = await fetch(`${BASE}/drop/${encodeURIComponent(name)}`, {
method: "PUT", headers: {Accept: "application/json"}, body: file,
});
return (await response.json()).file.ref;
}
// Step 2: run the tool with the reference.
let reply = await (await fetch(`${BASE}/v1/tools/qr-print`, {
method: "POST",
headers: {"Content-Type": "application/json"},
body: JSON.stringify({input: {"text":"https://setget.net","template":"table-tent","title":"Menu","preset":"ocean","accent":"#0c4a6e"}, wait: 30}),
})).json();
// Step 3: a job that is still running comes back as {job}. Wait for it.
while (!reply.result && ["queued", "running"].includes((reply.job || reply).status)) {
reply = await (await fetch(`${BASE}/v1/jobs/${(reply.job || reply).id}?wait=30`)).json();
}
if (reply.error) throw new Error(reply.error.message);
console.log(reply.result);
for (const file of reply.files) console.log(file.name, file.size, file.url, file.ref);
1. Upload. Tool: drop
Arguments:
{
"action": "create",
"files": []
}
PUT each file's bytes to its "upload.url" with the listed headers, and keep its "ref".
With a shell, one command does both: curl -T FILE https://setget.net/drop/
2. Run. Tool: run_tool
Arguments:
{
"slug": "qr-print",
"input": {
"text": "https://setget.net",
"template": "table-tent",
"title": "Menu",
"preset": "ocean",
"accent": "#0c4a6e"
}
}
3. The answer holds "result" and "files" (each with "url" and "ref").
If it holds a "job" that is still running instead, follow it. Tool: job
Arguments:
{
"action": "wait",
"id": "JOB_ID"
}
{
"input": {
"text": "https://setget.net",
"template": "table-tent",
"title": "Menu",
"preset": "ocean",
"accent": "#0c4a6e"
},
"wait": 30
}
This is a file tool, so a call takes three steps: upload the file to get a reference, run the tool with that reference, then read the result and download its files. Uploads and results are public by link and expire after one hour.
Endpoint: POST /v1/tools/qr-print. Over MCP: run_tool with slug: "qr-print".
Machine-readable: input schema, Markdown. Connect an agent.
Inputs
| Name | Type | Required | What it does |
|---|---|---|---|
text |
string | yes | The text or link to store in the code. For the WiFi card, the "text" of the WiFi QR tool's result. |
template |
string | no | The page to make. Print templates come out at their real size: poster, table-tent (fold the page in half), wifi-card, business-cards (ten to a sheet) and stickers (twelve to a sheet). The mockup templates are pictures of the code in use. One of: poster, table-tent, wifi-card, business-cards, stickers, mockup-poster, mockup-phone, mockup-tent, mockup-card, mockup-sticker. Default: "poster". |
title |
string | no | The headline, or the name on a business card. Left out, the template uses its own words ("Scan me", "Wi-Fi"); give an empty text for none. |
subtitle |
string | no | The line by the code, or the job title on a business card. Left out, the template uses its own words. |
details |
string | no | More lines, one per line: opening hours, an address, a phone number. On the WiFi card write "Label: value" lines, or leave this out and the network name and password are read from the code itself. |
page |
string | no | Paper size of the print templates. One of: a4, letter. Default: "a4". |
accent |
string | no | The color of the template's bands and highlights. Default: "#1d4ed8". |
paper |
string | no | The color of the page or card. Default: "#ffffff". |
format |
string | no | File to make: pdf at the real size for printing, or a png picture. One of: pdf, png. Default: "pdf". |
dpi |
integer | no | Dots per inch of a png of a print template. Default: 300. From 72 to 600. |
verify |
boolean | no | Read every code on a print template back with a decoder before returning the file. Default: true. |
error_correction |
string | no | How much damage the code survives: L about 7%, M 15%, Q 25%, H 30%. Higher levels hold less. Left out: M, or H when there is a logo. One of: L, M, Q, H. |
module_size |
integer | no | Width of one small square (module) in pixels. Default: 8. From 1 to 40. |
margin |
integer | no | Blank quiet zone around the code, in modules. Scanners expect at least 4. Default: 4. From 0 to 20. |
foreground |
string | no | Color of the dots: hex such as #000000, a basic color name, or a CSS linear-gradient(...) or radial-gradient(...). Left out: black. |
background |
string | no | Color behind the code: hex, a basic name, "transparent", or a CSS gradient. Left out: white. |
preset |
string | no | A ready-made look. Any style input you set yourself wins over the preset. One of: classic, rounded, liquid, dots, ocean, sunset, forest, grape, candy, ink, gold, midnight. |
dot_style |
string | no | Shape of the small squares (modules). Left out: square. One of: square, rounded, liquid, dots, diamond, star, vertical, horizontal, leaf, mosaic, plus, hexagon, heart, maze. |
dot_scale |
number | no | Size of each dot within its square, from 0.5 to 1. Thin shapes need more, such as diamond 0.7 and star 0.95 (the error names the least); liquid always fills its square. From 0.5 to 1. |
eye_frame_style |
string | no | Shape of the outer ring of the three corner eyes. One of: square, rounded, extra-rounded, circle, leaf, dotted. |
eye_ball_style |
string | no | Shape of the solid middle of the three corner eyes. One of: square, rounded, circle, diamond, leaf, octagon. |
eye_colour |
string | no | Color of the eye rings. Left out: the dot color. |
eye_ball_colour |
string | no | Color of the middle of the eyes. Left out: the eye ring color. |
eye_colours |
string | no | A color for each eye, separated by commas, in the order top-left, top-right, bottom-left: for instance "#b91c1c, #1d4ed8, #15803d". Plain colors only. An eye left out, or left empty between commas, keeps eye_colour. |
corner_radius |
number | no | Rounds the corners of the background, as a fraction of its side. From 0 to 0.5. |
shape |
string | no | Outline of the whole code: square, or a silhouette such as circle or heart. The code itself stays a complete square inside it, behind a clear ring as wide as margin, and matching dots fill the rest of the outline. Left out: square. One of: square, circle, squircle, octagon, hexagon, shield, bubble, heart. |
logo |
file | no | A picture for the middle of the code: PNG, JPEG, WebP, GIF or SVG. Large pictures are shrunk. In the API: a file reference such as DROP_ID/f1. Accepts: image. |
logo_size |
number | no | Largest logo width as a fraction of the code, from 0.1 to 0.4. It is made smaller when the code would not scan. Left out: 0.22. From 0.1 to 0.4. |
logo_padding |
number | no | Clear space around the logo, in modules. Left out: 1. From 0 to 3. |
logo_shape |
string | no | Shape of the clear area behind the logo. "none" leaves the background showing. One of: none, square, rounded, circle. |
logo_background |
string | no | Color of the clear area behind the logo. Left out: the background color. |
logo_text |
string | no | One to four characters for the middle of the code in place of a picture, such as initials. Drawn as outlines in the frame font, so they look the same everywhere. |
logo_icon |
string | no | A small symbol for the middle of the code in place of a picture. One of: heart, star, wifi, phone, mail, link, home, pin, cart, bag, camera, music, calendar, person, globe, lock, gift, cup, bolt, chat, play, info, tag, book. |
logo_colour |
string | no | Color of the center text or symbol. Left out: the eye color. |
background_image |
file | no | A photo to show behind the code. Large photos are shrunk. In the API: a file reference such as DROP_ID/f1. Accepts: image. |
background_image_wash |
number | no | How much the photo is lightened, from 0 to 0.9. Left out: 0.35. From 0 to 0.9. |
frame |
string | no | A border with a short call to action under (or above) the code. One of: none, label, banner, banner-top, rounded. |
frame_text |
string | no | The words in the frame. Left out: SCAN ME. |
frame_colour |
string | no | Color of the frame. Left out: the dot color. |
frame_text_colour |
string | no | Color of the frame text. Left out: whichever of dark or light reads best. |
frame_font |
string | no | Letter style of the frame text. One of: sans, mono. |
Examples
A table tent as a PDF: print, fold in half, stand it up
{
"text": "https://setget.net",
"template": "table-tent",
"title": "Menu",
"preset": "ocean",
"accent": "#0c4a6e"
}Press the example button above to run it on the sample file.
A WiFi card as a picture
{
"text": "WIFI:T:WPA;S:Cafe Luna Guests;P:espresso2026;;",
"template": "wifi-card",
"format": "png"
}Press the example button above to run it on the sample file.
Twelve round stickers on a Letter sheet
{
"text": "https://setget.net",
"template": "stickers",
"title": "Scan me",
"shape": "circle",
"margin": 2,
"page": "letter"
}Press the example button above to run it on the sample file.
Questions
- How do I get the size right?
- Print the PDF at 100 percent ("actual size"), not "fit to page". The result gives the printed width of the code and of one module in millimeters.
- What does verified mean here?
- The page was drawn at 150 dots per inch, a modest printer, and every code on it was read back by a decoder and gave exactly your text.
- How do I use the table tent?
- Print the page, fold it in half along the marks, and stand it up like a roof: both faces read the right way up.
- Can I see it first?
- Yes. The QR template tool shows the same page instantly, with the same inputs.
Related tools
- QR code poster, table tent and card templates
Put a styled QR code on a poster, table tent, WiFi card, business cards or stickers, or see it in a mockup.
qr-template - QR code export (PNG, PDF, EPS, GIF, MP4, print size)
Export a styled QR code as PNG, JPEG, WebP, SVG, PDF or EPS at any pixel or print size, or as an animated GIF, APNG or MP4, checked by a decoder.qr-export - Bulk QR code generator
Make up to 500 styled QR codes at once from a list or CSV: a zip of files plus an optional printable label sheet.qr-batch - WiFi QR code generator
Make a QR code that joins a WiFi network when scanned, with the network name and password escaped correctly.
qr-wifi - .gitignore generatorBuild a .gitignore for the languages, editors and operating systems you use, merged without duplicates.
gitignore-generate - Animated QR code
Make a QR code that draws itself: an animated SVG in any style that ends as a complete, scannable code.qr-animate