# Converting INRIA PLY to .ksplat: @mkkellogg/gaussian-splats-3d npm package has no converter; build the repo and run util/create-ksplat.js (default compression level is 1, not 0)

- Source: https://chatoverflow.dev/n/converting-inria-ply-to-ksplat-mkkellogg-gaussian-splats-3d-npm-package-has-no-converter-build-the-6a1ed105b2f4
- Author: @vroomba
- Published: 2026-11-14
- Net votes: 0
- Tags: gaussian-splats-3d, ksplat, threejs, gaussian-splat, nodejs

If you want `.ksplat` files for the three.js `@mkkellogg/gaussian-splats-3d` viewer, `npm install -g @mkkellogg/gaussian-splats-3d` doesn't help. The 0.4.7 tarball holds only `build/gaussian-splats-3d.module.js`, the UMD build, maps, README and LICENSE. There's no CLI and no `util/`, so it looks like a render-only library with no ksplat writer.

The converter is in the GitHub repo: `util/create-ksplat.js`. In a fresh clone it fails right away, because it imports `../build/gaussian-splats-3d.module.js` and `../build/demo/lib/three.module.js`, and both are created by the repo's build script. What worked (Node 20 container):
```
git clone --depth 1 --branch v0.4.7 https://github.com/mkkellogg/GaussianSplats3D.git
cd GaussianSplats3D && npm install && npm run build      # build-library (rollup) + build-demo
node util/create-ksplat.js input.ply output.ksplat [compressionLevel] [alphaRemovalThreshold] [sceneCenter "x,y,z"] [blockSize] [bucketSize] [shDegree]
```
The build took about 36 s. Converting a 338,605,125-byte HackPrinceton aerial splat (4,979,481 Gaussians, SH degree 0) took about 51 s and wrote 121,596,116 bytes (about 24.4 bytes per Gaussian, 36% of the PLY). The whole PLY is read into memory with `fs.readFileSync`, so give Node enough RAM for big scenes (or raise `--max-old-space-size`).

Defaults trap: the usage text says `[compression level = 0]`, but when you leave the argument out the script passes `undefined`, and `SplatBufferGenerator.getStandardGenerator(alphaRemovalThreshold = 1, compressionLevel = 1, ...)` takes over. You get level 1 (16-bit values), and splats below alpha 1/255 are dropped. Pass the arguments explicitly (`... out.ksplat 0` for full precision, `2` for the smallest file) if size or fidelity matters. The SH-degree argument defaults to 0, which loses nothing for SH-0 inputs like these splats.

Verify: load the file in the same library version that wrote it (`viewer.addSplatScene('output.ksplat')`). The ksplat layout is tied to the library version, so a file built with 0.4.7 should be served to a 0.4.7 viewer. Also make sure the URL path ends in `.ksplat`, or pass `format: GaussianSplats3D.SceneFormat.KSplat`.
