ogvs

A Go implementation of SVGO — the SVG Optimizer

Why?

SVGO is the industry-standard SVG optimizer, written in JavaScript. ogvs is a ground-up Go rewrite with behavioral compatibility — validated against all 363 SVGO test fixtures.

• Single binary — no Node.js or npm required
• Zero runtime dependencies — just download and run
• Fast — 5x to 23x faster than SVGO (benchmarks)
• Drop-in replacement — same plugins, same defaults, same output

Installation

Homebrew (macOS/Linux)

brew install okooo5km/tap/ogvs

Go install

go install github.com/okooo5km/ogvs/cmd/ogvs@latest

GitHub Releases

Download prebuilt binaries from the Releases page.

CLI Usage

# Optimize a file (in-place)
ogvs input.svg

# Optimize a file to a different output
ogvs input.svg -o output.svg

# Optimize from stdin
cat input.svg | ogvs -

# Optimize from string
ogvs -s '<svg><title>test</title></svg>'

# Optimize all SVGs in a folder (recursive)
ogvs -f ./icons -o ./optimized --recursive

# Multi-pass optimization (run until stable)
ogvs input.svg --multipass

# Pretty-print output
ogvs input.svg --pretty --indent 2

# Custom precision for numeric values
ogvs input.svg --precision 2

# Use a custom config file
ogvs input.svg --config ogvs.config.yaml

# List all available plugins
ogvs --show-plugins

Configuration

ogvs automatically discovers ogvs.config.yaml or ogvs.config.yml in the current directory (searching upward). You can also specify a config file with --config.

# ogvs.config.yaml
multipass: true
floatPrecision: 3

js2svg:
  pretty: true
  indent: 2

plugins:
  # Use preset-default with overrides
  - name: preset-default
    params:
      overrides:
        removeViewBox: false
        cleanupIds:
          minify: false

  # Enable optional plugins
  - name: removeXlink
  - name: prefixIds
    params:
      prefix: "icon-"
  - name: removeDimensions

Built-in Plugins

ogvs includes all 53 plugins from SVGO.

Preset Default (34 plugins)

These plugins run by default (in this order):

Optional Plugins (19 more)

These plugins are not included in the default preset and must be enabled explicitly:

API Usage (Go)

package main

import (
	"fmt"
	"log"

	"github.com/okooo5km/ogvs/internal/core"
)

func main() {
	input := `<svg xmlns="http://www.w3.org/2000/svg">
		<title>Example</title>
		<circle cx="50" cy="50" r="40"/>
	</svg>`

	result, err := core.Optimize(input, &core.Config{})
	if err != nil {
		log.Fatal(err)
	}
	fmt.Println(result.Data)
}

Differences from SVGO

ogvs aims for behavioral compatibility with SVGO. Known minor differences:

• Entity handling: When the SVG contains a DOCTYPE with entity definitions, ogvs outputs the DOCTYPE before the XML processing instruction (SVGO outputs them in the original order).
• Inline style colors: ogvs does not apply convertColors to inline style attribute values (fill:blue stays as-is, while SVGO may convert to fill:#00f).

Benchmark

Measured with hyperfine on macOS (Apple Silicon). Both tools produce identical output.

See doc/benchmark.md for full details and reproduction steps.

Development

make build        # Build binary to bin/ogvs
make test         # Run tests with race detection
make test-cover   # Run tests with coverage report
make lint         # Run golangci-lint
make fmt          # Format code
make vet          # Run go vet
make clean        # Remove build artifacts

License

MIT © okooo5km(十里)