CLI rendering ​

The render subcommand takes a Chart.js configuration as JSON and writes an image. It's the primary way to use chartjs2img: one input JSON in, one image out. Great for CI pipelines, Makefile targets, report generation scripts, and ad-hoc one-offs.

chartjs2img render [options]

If you haven't installed yet, see the Quick start.

Every example in this page renders a real Chart.js config. The embedded widgets let you flip between the rendered PNG, the JSON config, and a ready-to-paste CLI command:

PreviewJSONCLIFlip tabs to see JSON / CLI.

Usage patterns ​

From stdin ​

The default. Pipe JSON on stdin, write the image via -o.

echo '{"type":"bar","data":{"labels":["A","B","C"],"datasets":[{"data":[1,2,3]}]}}' \
  | chartjs2img render -o chart.png

From a file ​

chartjs2img render -i chart.json -o chart.png

To stdout ​

Omit -o (or pass -o -) and the binary image goes to stdout. Handy for piping directly into identify, magick, or an HTTP POST request.

chartjs2img render -i chart.json > chart.png

# Pipe the image straight into ImageMagick for post-processing
chartjs2img render -i chart.json | magick - -resize 640x jpg:chart.jpg

JPEG output ​

chartjs2img render -i chart.json -o chart.jpg -f jpeg -q 85

Custom dimensions, DPR, background ​

chartjs2img render -i chart.json -o wide.png -w 1200 -h 400
chartjs2img render -i chart.json -o retina.png --device-pixel-ratio 3
chartjs2img render -i chart.json -o transparent.png --background-color transparent

Input shape ​

The CLI input is the Chart.js config directly — no wrapper. Compare with the HTTP body, which wraps it in a chart field.

{
  "type": "bar",
  "data": {
    "labels": ["Jan", "Feb", "Mar"],
    "datasets": [
      { "label": "Sales", "data": [12, 19, 3], "backgroundColor": "rgba(54,162,235,0.7)" }
    ]
  },
  "options": {
    "plugins": {
      "title": { "display": true, "text": "Monthly Sales" }
    }
  }
}

Every type plus the options each plugin adds are documented in Bundled plugins, or run chartjs2img llm for the full LLM-targeted reference.

Flags ​

Other subcommands ​

chartjs2img examples ​

Render every built-in example into an output directory. Useful for smoke-testing a new plugin or Chromium version.

chartjs2img examples -o ./out
chartjs2img examples -o ./out -f jpeg -q 80

chartjs2img llm ​

Print the full Chart.js + plugin reference as Markdown, designed for piping into an LLM context window.

chartjs2img llm > reference.md
chartjs2img llm | pbcopy                              # macOS clipboard
chartjs2img llm | llm -s "Generate a stacked bar..."  # pipe to an LLM CLI

chartjs2img help / --help ​

Prints the full usage banner: every subcommand, every flag, every environment variable.

chartjs2img version / --version ​

Prints the version.

Exit codes ​

Chart.js runtime errors (invalid type, dataset shape mismatch, etc.) do not cause a non-zero exit. They are surfaced via stderr — see Error feedback.

Performance notes ​

• Chromium is launched on the first render in the process and reused for subsequent renders within the same invocation. One-shot CLI calls pay the launch cost (~300 ms) every time.
• For batch rendering of many charts, prefer chartjs2img examples -o ./out (which reuses one browser across all entries) or run the HTTP server and POST each chart.

Where to next ​

• Environment variables — tune Chromium discovery, render timeouts, and cache behavior for CLI use.
• Error feedback — how Chart.js warnings and errors appear on stderr.
• Bundled plugins — the 12 Chart.js plugins available without extra setup.