USVG(1)

📦
version 0.47.0 · 5 versions
, in ubuntu stonking

✨ USVG(1) ✨

okay bestie, welcome to the usvg page — that's User Commands section of the manual, section 1, so you know it's a command you actually run in your terminal 💅

🌸 NAME 🌸

usvg — usvg (micro SVG) is an SVG simplification tool. 🦋

💖 DESCRIPTION 💖

usvg (micro SVG) is an SVG simplification tool. that's literally it, that's the whole vibe — it takes your SVG and makes it micro. tiny. sleek. iconic. 👑

🎀 USAGE 🎀

four ways to run this thing, pick your fighter:

usvg [OPTIONS] <in-svg> <out-svg>
       # from file to file
usvg [OPTIONS] <in-svg> -c
       # from file to stdout
usvg [OPTIONS] - <out-svg>
       # from stdin to file
usvg [OPTIONS] - -c
       # from stdin to stdout

✨ OPTIONS ✨

  • -h, --help — prints help information. the classic. when in doubt, ask for help 🫶
  • -V, --version — prints version information. yes bestie we all love a version check ⭐
  • -c — prints the output SVG to the stdout. straight to your eyeballs, no file needed 💖
  • --dpi DPI — sets the resolution. default is 96. possible values: 10..4000 (inclusive) 🎯
  • --stylesheet PATH — inject a stylesheet that should be used when resolving CSS attributes. giving your SVG a lil CSS glow-up ✨
  • --languages LANG — sets a comma-separated list of languages that will be used during the 'systemLanguage' attribute resolving. examples: 'en-US', 'en-US, ru-RU', 'en, ru'. default: en 🌈
  • --shape-rendering HINT — selects the default shape rendering method. default: geometricPrecision. possible values: optimizeSpeed, crispEdges, geometricPrecision 👑
  • --text-rendering HINT — selects the default text rendering method. default: optimizeLegibility. possible values: optimizeSpeed, optimizeLegibility, geometricPrecision 📝
  • --image-rendering HINT — selects the default image rendering method. default: optimizeQuality. possible values: optimizeQuality, optimizeSpeed, smooth, high-quality, crisp-edges, pixelated 🖼️
  • --resources-dir DIR — sets a directory that will be used during relative paths resolving. expected to be the same as the directory that contains the SVG file, but can be set to any. default: input file directory, or none when reading from stdin 📁
  • --font-family FAMILY — sets the default font family that will be used when no 'font-family' is present. default: Times New Roman 🖋️
  • --font-size SIZE — sets the default font size that will be used when no 'font-size' is present. default: 12. possible values: 1..192 (inclusive) 🔢
  • --serif-family FAMILY — sets the 'serif' font family. will be used when no 'font-family' is present. default: Times New Roman 🎀
  • --sans-serif-family FAMILY — sets the 'sans-serif' font family. default: Arial 💫
  • --cursive-family FAMILY — sets the 'cursive' font family. default: Comic Sans MS 🌀 (yes fr fr, that's the default, no cap)
  • --fantasy-family FAMILY — sets the 'fantasy' font family. default: Impact 🔥
  • --monospace-family FAMILY — sets the 'monospace' font family. default: Courier New 💻
  • --use-font-file PATH — load a specified font file into the fonts database. will be used during text to path conversion. this option can be set multiple times 🫶
  • --use-fonts-dir PATH — loads all fonts from the specified directory into the fonts database. will be used during text to path conversion. this option can be set multiple times 📚
  • --skip-system-fonts — disables system fonts loading. you should add some fonts manually using --use-font-file and/or --use-fonts-dir — otherwise, text elements will not be processes 😭
  • --list-fonts — lists successfully loaded font faces. useful for debugging 🔍
  • --default-width LENGTH — sets the default width of the SVG viewport. like the '--default-height' option, this option controls what size relative units in the document will use as a base if there is no viewBox and document width or height are relative. values: 1..4294967295 (inclusive). default: 100 📏
  • --default-height LENGTH — sets the default height of the SVG viewport. refer to the explanation of the '--default-width' option. values: 1..4294967295 (inclusive). default: 100 📐
  • --preserve-text — do not convert text into paths 🚫
  • --id-prefix — adds a prefix to each ID attribute 🏷️
  • --indent INDENT — sets the XML nodes indent. values: none, 0, 1, 2, 3, 4, tabs. default: 4 🪜
  • --attrs-indent INDENT — sets the XML attributes indent. values: none, 0, 1, 2, 3, 4, tabs. default: none 🪜
  • --coordinates-precision NUM — set the coordinates numeric precision. smaller precision can lead to a malformed output in some cases. values: 2..8 (inclusive). default: 8 🎯
  • --transforms-precision NUM — set the transform values numeric precision. smaller precision can lead to a malformed output in some cases. values: 2..8 (inclusive). default: 8 🎯
  • --quiet — disables warnings 🤫

🦋 ARGS 🦋

  • <in-svg> — input file 📥
  • <out-svg> — output file 📤

that's the whole page bestie, go forth and simplify 🫶✨

usvg 0.47.0+ds — dropped August 2026, and this was your girl USVG(1) signing off 💖👑🎀

📦 where this page comes from