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.

1 The codes to make

One code per line, or CSV with a header: a text (or url) column and an optional name column. Use this or csv.

Choose a file or drop it here

Up to 100 MB.

A CSV or text file in the same form as rows. Use this or rows.
File for each code: svg, png or pdf.
Width of each png in pixels.
Also make a printable sheet of every code, for labels and stickers.
Codes across each sheet row.
Print each code's name (or text) under it on the sheet.
Read every code back with a decoder (slower).

2 Pick a look

Ready-made looks
A starting point. Anything you change below is kept on top of it.
Dots and corners
Dot style
Shape of the small squares (modules). Left out: square.
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.
Eye frame style
Shape of the outer ring of the three corner eyes.
Eye ball style
Shape of the solid middle of the three corner eyes.
Shape
Shape
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.
Colors
Color of the dots: hex such as #000000, a basic color name, or a CSS linear-gradient(...) or radial-gradient(...). Left out: black.
Color behind the code: hex, a basic name, "transparent", or a CSS gradient. Left out: white.
Color of the eye rings. Left out: the dot color.
Color of the middle of the eyes. Left out: the eye ring color.
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.
Rounds the corners of the background, as a fraction of its side.
Logo

You can also paste an image. Up to 100 MB.

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
A small symbol for the middle of the code in place of a picture.
Color of the center text or symbol. Left out: the eye color.
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.
Clear space around the logo, in modules. Left out: 1.
Logo shape
Shape of the clear area behind the logo. "none" leaves the background showing.
Color of the clear area behind the logo. Left out: the background color.
Photo background

Choose a file or drop it here

You can also paste an image. Up to 100 MB.

A photo to show behind the code. Large photos are shrunk.
How much the photo is lightened, from 0 to 0.9. Left out: 0.35.
Frame
Frame
A border with a short call to action under (or above) the code.
The words in the frame. Left out: SCAN ME.
Color of the frame. Left out: the dot color.
Color of the frame text. Left out: whichever of dark or light reads best.
Letter style of the frame text.
Size and safety
Error correction
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.
Blank quiet zone around the code, in modules. Scanners expect at least 4.
Width of one small square (module) in pixels.

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

NameTypeRequiredWhat 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.