Sign Up for Free

RunKit +

Try any Node.js package right in your browser

This is a playground to test code. It runs a full Node.js environment and already has all of npm’s 400,000 packages pre-installed, including svgo with all npm packages installed. Try it out:

var svgo = require("svgo")

This service is provided by RunKit and is not affiliated with npm, Inc or the package authors.

svgo v1.3.2

Nodejs-based tool for optimizing SVG vector graphics files

english | русский


logo

SVGO NPM version Build Status Coverage Status

SVG Optimizer is a Nodejs-based tool for optimizing SVG vector graphics files.

Why?

SVG files, especially those exported from various editors, usually contain a lot of redundant and useless information. This can include editor metadata, comments, hidden elements, default or non-optimal values and other stuff that can be safely removed or converted without affecting the SVG rendering result.

What it can do

SVGO has a plugin-based architecture, so almost every optimization is a separate plugin.

Today we have:

PluginDescriptionDefault
cleanupAttrscleanup attributes from newlines, trailing, and repeating spacesenabled
inlineStylesmove and merge styles from <style> elements to element style attributesenabled
removeDoctyperemove doctype declarationenabled
removeXMLProcInstremove XML processing instructionsenabled
removeCommentsremove commentsenabled
removeMetadataremove <metadata>enabled
removeTitleremove <title>enabled
removeDescremove <desc>enabled
removeUselessDefsremove elements of <defs> without idenabled
removeXMLNSremoves xmlns attribute (for inline svg)disabled
removeEditorsNSDataremove editors namespaces, elements, and attributesenabled
removeEmptyAttrsremove empty attributesenabled
removeHiddenElemsremove hidden elementsenabled
removeEmptyTextremove empty Text elementsenabled
removeEmptyContainersremove empty Container elementsenabled
removeViewBoxremove viewBox attribute when possibleenabled
cleanupEnableBackgroundremove or cleanup enable-background attribute when possibleenabled
minifyStylesminify <style> elements content with CSSOenabled
convertStyleToAttrsconvert styles into attributesenabled
convertColorsconvert colors (from rgb() to #rrggbb, from #rrggbb to #rgb)enabled
convertPathDataconvert Path data to relative or absolute (whichever is shorter), convert one segment to another, trim useless delimiters, smart rounding, and much moreenabled
convertTransformcollapse multiple transforms into one, convert matrices to the short aliases, and much moreenabled
removeUnknownsAndDefaultsremove unknown elements content and attributes, remove attrs with default valuesenabled
removeNonInheritableGroupAttrsremove non-inheritable group's "presentation" attributesenabled
removeUselessStrokeAndFillremove useless stroke and fill attrsenabled
removeUnusedNSremove unused namespaces declarationenabled
prefixIdsprefix IDs and classes with the SVG filename or an arbitrary stringdisabled
cleanupIDsremove unused and minify used IDsenabled
cleanupNumericValuesround numeric values to the fixed precision, remove default px unitsenabled
cleanupListOfValuesround numeric values in attributes that take a list of numbers (like viewBox or enable-background)disabled
moveElemsAttrsToGroupmove elements' attributes to their enclosing groupenabled
moveGroupAttrsToElemsmove some group attributes to the contained elementsenabled
collapseGroupscollapse useless groupsenabled
removeRasterImagesremove raster imagesdisabled
mergePathsmerge multiple Paths into oneenabled
convertShapeToPathconvert some basic shapes to <path>enabled
convertEllipseToCircleconvert non-eccentric <ellipse> to <circle>enabled
sortAttrssort element attributes for epic readabilitydisabled
sortDefsChildrensort children of <defs> in order to improve compressionenabled
removeDimensionsremove width/height and add viewBox if it's missing (opposite to removeViewBox, disable it first)disabled
removeAttrsremove attributes by patterndisabled
removeAttributesBySelectorremoves attributes of elements that match a css selectordisabled
removeElementsByAttrremove arbitrary elements by ID or classNamedisabled
addClassesToSVGElementadd classnames to an outer <svg> elementdisabled
addAttributesToSVGElementadds attributes to an outer <svg> elementdisabled
removeOffCanvasPathsremoves elements that are drawn outside of the viewboxdisabled
removeStyleElementremove <style> elementsdisabled
removeScriptElementremove <script> elementsdisabled
reusePathsFind duplicated elements and replace them with linksdisabled

Want to know how it works and how to write your own plugin? Of course you want to. (동작방법)

Installation

$ [sudo] npm install -g svgo

Usage

CLI

Usage:
  svgo [OPTIONS] [ARGS]

Options:
  -h, --help : Help
  -v, --version : Version
  -i INPUT, --input=INPUT : Input file, "-" for STDIN
  -s STRING, --string=STRING : Input SVG data string
  -f FOLDER, --folder=FOLDER : Input folder, optimize and rewrite all *.svg files
  -o OUTPUT, --output=OUTPUT : Output file or folder (by default the same as the input), "-" for STDOUT
  -p PRECISION, --precision=PRECISION : Set number of digits in the fractional part, overrides plugins params
  --config=CONFIG : Config file or JSON string to extend or replace default
  --disable=PLUGIN : Disable plugin by name, "--disable=PLUGIN1,PLUGIN2" for multiple plugins
  --enable=PLUGIN : Enable plugin by name, "--enable=PLUGIN3,PLUGIN4" for multiple plugins
  --datauri=DATAURI : Output as Data URI string (base64, URI encoded or unencoded)
  --multipass : Pass over SVGs multiple times to ensure all optimizations are applied
  --pretty : Make SVG pretty printed
  --indent=INDENT : Indent number when pretty printing SVGs
  -r, --recursive : Use with '-f'. Optimizes *.svg files in folders recursively.
  -q, --quiet : Only output error messages, not regular status messages
  --show-plugins : Show available plugins and exit

Arguments:
  INPUT : Alias to --input
  • with files:

    $ svgo test.svg
    

    or:

    $ svgo *.svg
    
    $ svgo test.svg -o test.min.svg
    
    $ svgo test.svg other.svg third.svg
    
    $ svgo test.svg other.svg third.svg -o test.min.svg -o other.min.svg -o third.min.svg
    
  • with STDIN / STDOUT:

    $ cat test.svg | svgo -i - -o - > test.min.svg
    
  • with folder

    $ svgo -f ../path/to/folder/with/svg/files
    

    or:

    $ svgo -f ../path/to/folder/with/svg/files -o ../path/to/folder/with/svg/output
    
    $ svgo *.svg -o ../path/to/folder/with/svg/output
    
  • with strings:

    $ svgo -s '<svg version="1.1">test</svg>' -o test.min.svg
    

    or even with Data URI base64:

    $ svgo -s 'data:image/svg+xml;base64,...' -o test.min.svg
    
  • with SVGZ:

    from .svgz to .svg:

    $ gunzip -c test.svgz | svgo -i - -o test.min.svg
    

    from .svg to .svgz:

    $ svgo test.svg -o - | gzip -cfq9 > test.svgz
    

Other Ways to Use SVGO

Backers

SheetJS LLCFontello

Donations

  • PayPal: https://www.paypal.me/deepsweet

License and Copyright

This software is released under the terms of the MIT license.

Logo by Yegor Bolshakov.

Metadata

RunKit is a free, in-browser JavaScript dev environment for prototyping Node.js code, with every npm package installed. Sign up to share your code.
Sign Up for Free