PNGToSVG

A high-performance tool written in Rust that converts PNG raster images into SVG vectors.

Note: This is a fast, standalone Rust rewrite of our original Python prototype. The old code is archived in /legacy_python.

Installation

For Users: Download the standalone executable for your system from the Releases page. No dependencies required.

For Developers:

cargo install pngtosvg

Usage

Command Line (CLI)

pngtosvg image.png         # Convert a single file
pngtosvg ./assets/icons/   # Convert a specific folder
pngtosvg .                 # Convert the current directory

(Note for Linux/macOS: If not in your PATH, prefix the executable with ./)

Windows Desktop GUI

You don't need the terminal to use this tool on Windows:

• Drag & Drop: Drag your .png files directly onto the executable.
• Double Click: Double-click the executable to automatically convert all images in the same folder.

<p align="center"> <img src="./resources/draganddrop.gif" alt="Drag and drop" width="48%"> <img src="./resources/doubleclick.gif" alt="Double click" width="48%"> </p>

Use as a Rust Library

Add the dependency to your project:

cargo add pngtosvg

Minimal Example:

use pngtosvg::convert_file_to_svg;
use std::path::Path;

fn main() {
    let svg_content = convert_file_to_svg(Path::new("image.png")).unwrap();
    println!("{}", svg_content);
}

For advanced features, including in-memory RgbaImage conversions, please read the official documentation on docs.rs.