Badge maker (PNG)

Make a shields-style status badge as a PNG picture, at one to four times its normal size.

Input

Left-hand text. Leave empty for a badge with only a message.
Right-hand text.
Message background: a name such as brightgreen, red or blue, or hex such as #4c1.
Label background: a name or hex.
Badge shape.
Size multiplier: 2 is sharp on high-density screens.

Result

Choose a file and press Run.

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

curl -s https://setget.net/v1/tools/badge-png \
  -H 'Content-Type: application/json' \
  -d '{"input":{"label":"build","message":"passing","color":"brightgreen"},"wait":30}'
import json, urllib.request

body = {'input': {'label': 'build', 'message': 'passing', 'color': 'brightgreen'}, 'wait': 30}
request = urllib.request.Request("https://setget.net/v1/tools/badge-png", json.dumps(body).encode(),
                                 {"Content-Type": "application/json"})
print(json.load(urllib.request.urlopen(request))["result"])
const response = await fetch("https://setget.net/v1/tools/badge-png", {
  method: "POST",
  headers: {"Content-Type": "application/json"},
  body: JSON.stringify({"input":{"label":"build","message":"passing","color":"brightgreen"},"wait":30}),
});
console.log((await response.json()).result);
Tool: run_tool
Arguments:
{
  "slug": "badge-png",
  "input": {
    "label": "build",
    "message": "passing",
    "color": "brightgreen"
  },
  "wait": 30
}
{
  "input": {
    "label": "build",
    "message": "passing",
    "color": "brightgreen"
  },
  "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/badge-png. Over MCP: run_tool with slug: "badge-png". Machine-readable: input schema, Markdown. Connect an agent.

Inputs

NameTypeRequiredWhat it does
label string no Left-hand text. Leave empty for a badge with only a message.
message string yes Right-hand text.
color string no Message background: a name such as brightgreen, red or blue, or hex such as #4c1. Default: "blue".
label_color string no Label background: a name or hex. Default: "#555".
style string no Badge shape. One of: flat, flat-square, plastic, for-the-badge, social. Default: "flat".
logo string no An icon at the left, such as github, python or docker. One of: alert, apple, aws, check, cloudflare, code, discord, docker, eye, flame, git, github, gitlab, go, heart, javascript, kubernetes, linux, mongodb, nodejs, npm, postgresql, python, redis, rust, shield, star, terminal, typescript, windows, zap.
link string no Where the badge links to inside the SVG: an http or https address, or "none". Default: "none".
scale integer no Size multiplier: 2 is sharp on high-density screens. Default: 2. From 1 to 4.

Example

A green build badge

Input
{
  "label": "build",
  "message": "passing",
  "color": "brightgreen"
}
Result

Press the example button above to make it.

Questions

Why is the text in a different font?
The PNG is drawn with the fonts installed on the worker; Verdana is replaced by DejaVu Sans, which is close in width.