svg2vector

English | 中文

The missing SVG → VectorDrawable CLI for Android.

Android Studio's Vector Asset Studio is GUI-only. Google's official android CLI ships with create, emulator, sdk, skills... but no SVG conversion. So in 2026 you still need to launch a 1 GB IDE and click through dialogs just to turn an icon into a drawable.

svg2vector is the headless, agent-callable CLI that should have shipped: same Svg2Vector algorithm Android Studio uses internally, packaged as a ~24 MB native binary with ~8 ms cold start. Wire it into Claude, agents, scripts, or CI.

Under the hood it wraps Android's official com.android.ide.common.vectordrawable.Svg2Vector (com.android.tools:sdk-common) — the exact class the Vector Asset Studio GUI runs. Anything the GUI can convert, this CLI can convert, byte-for-byte the same.

In Claude Code:

/plugin marketplace add HelloVass/svg2vector-skills
/plugin install svg2vector

Once installed:

• Active: /svg2vector convert <input.svg> slash command
• Passive: just say convert all SVGs under ./design/svgs into vectordrawables and put them in app/src/main/res/drawable/ — the skill auto-activates.

On first use the slash command will offer to install the native binary (~24 MB):

curl -fsSL https://raw.githubusercontent.com/HelloVass/svg2vector-skills/main/install.sh | sh

curl -fsSL https://raw.githubusercontent.com/HelloVass/svg2vector-skills/main/install.sh | sh
svg2vector --version

install.sh auto-detects OS and arch (darwin-arm64 / darwin-x86_64 / linux-x86_64), pulls the matching native binary from GitHub Releases, and drops it at ~/.local/bin/svg2vector.

svg2vector convert input.svg                  # writes input.xml beside it
svg2vector convert input.svg -o out/icon.xml  # explicit output path

svg2vector batch ./svgs ./drawable
svg2vector batch ./svgs ./drawable -r         # recurse into subdirectories

svg2vector --help
svg2vector --version
svg2vector convert --help
svg2vector batch --help

In batch mode, the process exits with the worst per-file code (max). A single warning anywhere in the batch surfaces as exit 2 overall.

stdout carries success messages only (wrote ..., batch summary like done: N ok, M warned, K failed). stderr carries errors and "feature X is not supported" warnings. The two streams are deliberately separated so agents can capture them independently.

out=$(svg2vector convert icon.svg -o icon.xml 2>err.log)
rc=$?
case $rc in
  0) echo "clean: $out" ;;
  2) echo "converted with dropped features (see err.log)" ;;
  *) echo "failed rc=$rc (see err.log)" ;;
esac

Supported: path / rect / circle / ellipse / line / polygon / polyline / g (transforms baked into paths) / basic fill / stroke / opacity / linearGradient / radialGradient / clipPath.

Silently dropped (exit 2 + stderr warning): text / filter / mask / pattern / image / external <use> / CSS @import / some advanced gradient features.

• ✅ SVGs from Figma's Export panel (literal hex colors): drop straight in.

• ⚠️ SVGs from Figma's Dev Mode (localhost:3845/assets/...svg) embed var(--token, fallback) CSS variables. Svg2Vector doesn't resolve those — output strokes / fills become unusable strings. Pre-process:

  sed -E 's/var\(--[^,]+,\s*([^)]+)\)/\1/g' input.svg > clean.svg

• The conversion algorithm is Android tooling's Svg2Vector (com.android.tools:sdk-common).
• Four of the regression test fixtures are taken from the Ashung/svg2vectordrawable issue tracker — credit to the upstream community for reporting these bugs over the years.

MIT