Skip to main content

Convert

The Convert page is a browser-based tool for converting splats between formats, transforming, filtering and decimating them, and combining several into one. There's no installation and no command line. It's the web frontend to the splat-transform CLI, and its header shows which splat-transform release it runs.

Convert runs entirely in your browser. Your splats are never uploaded to a server: everything happens on your computer, and the result is saved back to it.

The page has two tabs:

  • Convert converts, transforms and combines splat files.
  • Streamed SOG builds a Streamed SOG, with levels of detail, from a large splat.

When to use Convert vs the CLI​

Use the Convert page when you want a single one-off conversion, want to experiment interactively, or don't have Node.js installed. Use the splat-transform CLI when you need to script conversions, batch many files, or integrate with a build pipeline.

Converting splats​

The Convert tab with a splat added, a Rotate action on the file, SOG output, Decimate on and an output action

Input files​

Drag files onto Input Files, or click it to choose from your filesystem. It accepts:

  • .ply — Standard PLY
  • .sog — SuperSplat Optimized
  • .ksplat — mkkellogg compressed format
  • .splat — antimatter15 compressed format
  • .spz — Niantic compressed format

Each file you add is listed with its Gaussian count, its spherical harmonic (SH) bands and its size. A file that can't be read shows Unreadable or corrupt file. When you add more than one file, they're combined into one output.

Click a file to show its own actions, which are applied to that file before the files are combined. A badge on the file shows how many it has.

Output​

SettingDescription
FormatThe output format. See the table below. The default is Standard PLY.
FilenameThe output file's name, without its extension. It starts as the first input file's name.
SH Compression IterationsShown for SOG and Embedded Viewer output. The number of clustering passes used to compress the spherical harmonics (1–100, default 10). More iterations give better quality but take longer.
Voxel ResolutionShown for Voxel Collision Bundle output. The voxel size in world units (default 0.05). Smaller voxels give more detail but take longer.
Opacity CutoffShown for Voxel Collision Bundle output. Voxels above this opacity are treated as solid (default 0.1).
FormatFilenameNotes
Standard PLY.plyDefault. Largest; useful as a lossless interchange format.
Compressed PLY.compressed.plyQuantized PLY, smaller than standard PLY.
SuperSplat Optimized.sogBest compression for runtime use.
Spreadsheet.csvPer-Gaussian data dumped to CSV for spreadsheet or data analysis.
Embedded Viewer.htmlA self-contained .html file with the splat and the viewer. Open it locally with a double-click.
Voxel Collision Bundle.voxel.zipVoxel collision data for making your scene walkable in Studio.

SOG, Embedded Viewer and Voxel Collision Bundle output are produced on the GPU, so they need a browser with WebGPU, such as Chrome or Edge 113 or later.

Decimate​

Turn on Decimate to reduce the splat count by merging similar Gaussians. The slider sets how many to keep, from 1% to 100% (default 50%), and shows the resulting count, such as Keep 50% — ≈ 76,395 of 152,789 Gaussians.

Actions​

Actions transform or filter the splat data. Each input file has its own actions, and Output Actions are applied to the combined result before it's written. Click Add Action to add one. Actions run top to bottom, in the order you add them. Click an action's close button to remove it.

Transform actions:

ActionParametersDefault
TranslateX, Y, Z0, 0, 0
Rotate (degrees)X, Y, Z0, 0, 0
ScaleFactor1 (min 0.001)

Filter actions:

ActionParametersDefault
Remove NaN/Inf(none)—
SH BandsMax Band: 0 (DC only), 1, 2 or 3 (Full)3
Bounding BoxMin X, Min Y, Min Z, Max X, Max Y, Max Z±10
Sphere FilterCenter X, Center Y, Center Z, Radiuscenter 0, radius 10

Converting​

Click Convert & Save… to choose where to save the result, then convert. In browsers that can't save files directly, the button reads Convert & Download instead, and the result downloads when it's ready.

While it works, the page shows its progress and a log of messages from splat-transform. When it finishes, a Data Summary shows the Total Gaussians, the number of Columns, and the minimum, maximum and mean of each column.

Streamed SOG​

The Streamed SOG tab, at superspl.at/convert/streamed-sog, builds a Streamed SOG from a large splat. It builds the levels of detail the viewer streams, then writes them as a Streamed SOG that you can upload or host yourself. It runs on your computer, using its GPU, and nothing is uploaded.

It needs desktop Chrome or Edge. It uses WebGPU, and it saves its work to a folder on your computer, which only those browsers can do.

The Streamed SOG tab, with steps to choose a source file and a working folder, and the output options

Building a Streamed SOG​

  1. Under 1 · Source file, drop a PLY, SPZ, SOG, SPLAT or KSPLAT file, or click Choose file.
  2. Under 2 · Working folder, drop a folder, or click Choose folder. The tool saves its work files and the result there, so pick a drive with plenty of free space.
  3. Check What to expect: how many levels of detail it will build, the free disk space it needs, and roughly how much memory it uses and how large the result is. SPZ and KSPLAT files need extra memory, because they're decompressed while they're prepared.
  4. Choose the Output: a Folder, or a Zip, ready to upload. Tick Keep the work files to keep each level of detail as a PLY, in a supersplat-temp folder in the working folder.
  5. Click Start.

The conversion runs in four steps, shown with their progress and an estimate of the time left:

StepWhat it does
Prepare sourceRemoves invalid and transparent splats, and sorts the rest spatially.
Build detail levelsBuilds each level of detail. A splat with fewer than 1 million Gaussians needs no extra levels.
Write streamed SOGEncodes the levels into the Streamed SOG.
Clean upRemoves the work files, unless you chose to keep them.

When it's done, Streamed SOG ready shows where it was saved, with its number of levels, Gaussians, size and time taken. If you chose a zip, Upload to SuperSplat opens the upload page, where you choose the zip from your working folder.

Pausing and resuming​

A large conversion can take a long time. Click Pause to stop it; you can close the tab once it's paused. The step that was in progress restarts when you resume, and finished steps are kept.

When you come back, the page lists your Unfinished conversions, each with a Resume button. Chrome may ask you to allow access to the source file and the working folder again.

Canceling a conversion deletes its work files. Your source file is never changed.

Each file can only be converted in one tab at a time. Running two conversions at once in different tabs needs about twice the memory, and both run slower.

See also​