Badge maker (PNG)
Make a shields-style status badge as a PNG picture, at one to four times its normal size.
Input
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
| Name | Type | Required | What 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.
Related tools
- Badge makerMake a shields-style status badge as SVG from a label, a message and a colour, in five styles.
badge-svg - SVG to PNGRender an SVG drawing to a PNG image at any size, with a transparent or solid background.
svg-to-png - .gitignore generatorBuild a .gitignore for the languages, editors and operating systems you use, merged without duplicates.
gitignore-generate - ASCII banner text generatorTurn short text into large five-line banner letters for terminals, READMEs, logs and code comments.
ascii-banner - ASCII table generatorRender headers and rows as a box-drawing or plain ASCII table for terminals, logs and code comments.
ascii-table - Background pattern generatorMake seamless SVG background patterns (dots, grid, stripes, checker or waves) with your colours and scale.
pattern-image