SplatThis

Turn a PNG or JPEG into a portable scene of editable 2D Gaussian splats.

SplatThis fits one Gaussian population and exports it directly to five formats:

The default installation is deliberately small: NumPy, Pillow, and Torch. MLX, browser capture, and low-bit population embedding are opt-in.

Install

SplatThis requires Python 3.11 or newer.

pip install splatthis

Optional capabilities are installed separately:

pip install "splatthis[mlx]"      # MLX on Apple Silicon
pip install "splatthis[capture]"  # Playwright client for Chrome/Chromium
pip install "splatthis[steg]"     # low-bit PNG population carrier

Command line

SVG is the default output:

splatthis input.png -o output.svg

Select another target with --format:

splatthis input.png --format pptx   -o output.pptx
splatthis input.png --format canvas -o output-canvas.html
splatthis input.png --format css    -o output-css.html
splatthis input.png --format eml    -o output.eml

Control the fit with a small set of explicit options:

splatthis input.jpg --format pptx \
  --splats 3000 \
  --stages 300,200,100 \
  --max-edge 512 \
  --seed 42 \
  -o output.pptx

Use MLX explicitly on an Apple-Silicon Metal session:

splatthis input.png --optimizer-backend mlx -o output.svg

If MLX cannot allocate a Metal device, SplatThis warns and falls back to Torch before fitting.

Capture native output

Capture SVG, CSS, or Canvas output with an installed Chrome/Chromium browser:

splatthis input.png --format css -o output.html --capture capture.png

On macOS, PPTX capture uses installed Microsoft PowerPoint through OSA and the system screenshot utility, with no additional Python package:

splatthis input.png --format pptx -o output.pptx --capture powerpoint.png

macOS may request Automation, Accessibility, and Screen Recording permission.

Recoverable populations

SVG and PPTX can carry the compressed population that produced them. Preview PNGs can carry the same envelope in metadata and, with the steg extra, in one or two low bits per channel:

splatthis input.png -o output.svg --embed-population
splatthis input.png -o output.svg \
  --preview preview.png \
  --embed-population \
  --embed-population-in-pixels

Embedded populations are derivatives of the input image. Pixel embedding is not a security feature, changes pixels slightly, and has finite capacity.

Python API

from splatthis import SplatConverter

converter = SplatConverter(
    max_splats=2000,
    stages=[200, 150, 100, 50],
    quality_profile="max-fidelity",
    device="cpu",
    seed=42,
)
converter.convert("input.png", "output.pptx", output_format="pptx")

The historical PNG2SVGConverter name remains available. Direct emitters are also public for applications that already have a GaussianSplat population.

Project

• Source and full documentation
• Issue tracker
• Security policy

SplatThis is released under the MIT License.