CLI Utility

gsbox

gsbox is a cross-platform command-line tool focused on Gaussian Splatting format conversion, inspection, transforms, and merging.

Stage: Utility / ConversionBatch conversionFormat inspectionSPZ and SOG pipelines

What It Does

gsbox is useful because practical 3DGS work often becomes format plumbing. One tool outputs PLY, another wants SPZ, a web pipeline wants SOG, and you may need to inspect headers or rotate a scene before publishing.

It overlaps with GaussForge and SplatTransform, but it is worth listing because it covers a broad matrix of read/write formats and has explicit commands for transforms and merging.

How To Use It In 3DGS

  • Install or build gsbox from the GitHub repository for your platform.
  • Run `info` first on unfamiliar assets so you understand format, count, SH degree, and metadata before conversion.
  • Convert into the target format required by your viewer, for example PLY to SPZ or PLY to SOG.
  • Use transform options only when you know the target coordinate expectations; record every rotation, scale, and translation applied.

Things To Watch

  • Format conversion can be lossy depending on target format and options.
  • Transform commands are powerful but easy to misuse; keep an untouched source file and a conversion log.
  • SPX is useful in the gsbox ecosystem, but it is not as broadly supported as PLY, SPZ, SOG, or KSPLAT.

Where gsbox Shines

  • Use it when you need one CLI to inspect several splat formats rather than only convert one pair.
  • The merge workflow is helpful for experiments that combine multiple scans into a single delivery file, though visual seams and coordinate alignment remain your responsibility.
  • The SOG and SPZ options make it useful as a bridge between Scaniverse-style mobile assets and PlayCanvas-style web delivery assets.

Conversion Checklist

  • Preview source and output in the same neutral viewer before reporting a conversion issue.
  • Check whether the target viewer expects SH0-only or higher-order spherical harmonics.
  • Measure output size and first-load time, not just screenshot quality.