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.
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-batch \
-H 'Content-Type: application/json' \
-d '{"input":{"rows":"name,url\nTable 1,https://example.com/menu?t=1\nTable 2,https://example.com/menu?t=2","preset":"rounded","sheet":"a4"},"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": {'rows': 'name,url\nTable 1,https://example.com/menu?t=1\nTable 2,https://example.com/menu?t=2', 'preset': 'rounded', 'sheet': 'a4'}, "wait": 30}
reply = call("POST", "/v1/tools/qr-batch", 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-batch`, {
method: "POST",
headers: {"Content-Type": "application/json"},
body: JSON.stringify({input: {"rows":"name,url\nTable 1,https://example.com/menu?t=1\nTable 2,https://example.com/menu?t=2","preset":"rounded","sheet":"a4"}, 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-batch",
"input": {
"rows": "name,url\nTable 1,https://example.com/menu?t=1\nTable 2,https://example.com/menu?t=2",
"preset": "rounded",
"sheet": "a4"
}
}
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": {
"rows": "name,url\nTable 1,https://example.com/menu?t=1\nTable 2,https://example.com/menu?t=2",
"preset": "rounded",
"sheet": "a4"
},
"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-batch. Over MCP: run_tool with slug: "qr-batch".
Machine-readable: input schema, Markdown. Connect an agent.
Inputs
| Name | Type | Required | What it does |
|---|---|---|---|
rows |
string | no | One code per line, or CSV with a header: a text (or url) column and an optional name column. Use this or csv. |
csv |
file | no | A CSV or text file in the same form as rows. Use this or rows. In the API: a file reference such as DROP_ID/f1. Accepts: text. |
format |
string | no | File for each code: svg, png or pdf. One of: svg, png, pdf. Default: "png". |
size |
integer | no | Width of each png in pixels. Default: 1024. From 64 to 2048. |
sheet |
string | no | Also make a printable sheet of every code, for labels and stickers. One of: none, a4, letter. Default: "none". |
per_row |
integer | no | Codes across each sheet row. Default: 3. From 2 to 6. |
labels |
boolean | no | Print each code's name (or text) under it on the sheet. Default: true. |
verify |
boolean | no | Read every code back with a decoder (slower). Default: false. |
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. |
Example
Table cards with a printable sheet
Input
{
"rows": "name,url\nTable 1,https://example.com/menu?t=1\nTable 2,https://example.com/menu?t=2",
"preset": "rounded",
"sheet": "a4"
}Result
Press the example button above to run it on the sample file.
Questions
- How do I name the files?
- Give a CSV with a name column: each file and sheet label uses it. Otherwise the file names come from the text itself.
- What if a line is wrong?
- It is skipped and listed under "skipped" with the reason; the other codes are still made.
- Can each code have a different style?
- Not in one batch: every code gets the same style inputs. Run one batch per style.
Related tools
- QR code generator
Make a scannable QR code from any text or link, styled your way: colors, gradients, dot shapes, a logo and a frame.
qr-generate - 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 - Contact (vCard) QR code generator
Make a QR code that adds a contact to a phone when scanned: name, phone, email, organization and website.
qr-vcard - .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 - ASCII banner text generatorTurn short text into large five-line banner letters for terminals, READMEs, logs and code comments.
ascii-banner