Skip to content
forked from svg/svgo

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

License

Notifications You must be signed in to change notification settings

nullnotfound/svgo

Repository files navigation

o-o o   o o--o o-o
 \   \ /  |  | | |
o-o   o   o--o o-o
             |
          o--o

SVGO Build Status

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

Why?

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

What it can do

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

Today we have:

  • [ > ] cleanup attributes from newlines, trailing and repeating spaces
  • [ > ] remove doctype declaration
  • [ > ] remove XML processing instructions
  • [ > ] remove comments
  • [ > ] remove metadata
  • [ > ] remove editors namespaces, elements and attributes
  • [ > ] remove empty attributes
  • [ > ] remove default "px" unit
  • [ > ] remove a lot of hidden elements
  • [ > ] remove empty Text elements
  • [ > ] remove empty Container elements
  • [ > ] remove viewBox attribute
  • [ > ] remove or cleanup enable-background attribute
  • [ > ] cleanup SVG element from useless attributes
  • [ > ] convert styles into attributes
  • [ > ] convert colors (from rgb() to #rrggbb, from #rrggbb to #rgb)
  • [ > ] convert Path data to relative, convert one segment to another, trim useless delimiters and much more
  • [ > ] collapse multiple transforms into one, convert matrices to the short aliases and much more
  • [ > ] remove unused namespaces declaration
  • [ > ] move elements attributes to the existing group wrapper
  • [ > ] collapse groups

Want to know how it works and how to write your own plugin? Of course you want to.

How to use

Latest stable v0.0.9 from npm and docs are here.

$ [sudo] npm install -g svgo
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 (by default the same as the input), "-" for STDOUT
  -c CONFIG, --config=CONFIG : Local config file to extend default
  --disable=DISABLE : Disable plugin by name
  --enable=ENABLE : Enable plugin by name
  --datauri : Output as Data URI base64 string
  --pretty : Make SVG pretty printed

Arguments:
  INPUT : Alias to --input
  OUTPUT : Alias to --output
  • with files:
$ svgo test.svg
$ svgo test.svg test.min.svg
  • with STDIN / STDOUT:
$ cat test.svg | svgo -i - -o - > test.min.svg
  • with folder
$ svgo -f ../path/to/folder/with/svg/files
  • with strings (even with Data URI base64):
$ svgo -s '<svg version="1.1">test</svg>' -o test.min.svg
$ svgo -s 'data:image/svg+xml;base64,…' -o test.min.svg
  • with GUI (currently Mac OS X app only)
  • as a Nodejs module - examples

TODO

License

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

About

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

Resources

License

Stars

Watchers

Forks

Packages

No packages published