Skip to content

StorySplat Tools Overview

StorySplat Tools is a desktop application for creating and processing Gaussian Splat content.

Features

Format Conversion

Convert between splat formats for optimal delivery: - PLY ↔ SOG (optimized for web) - PLY ↔ Compressed PLY - Batch conversion support

Image to Splat

Create 3D Gaussian Splats from images: - SHARP (Structure from Motion) processing - COLMAP integration - GPU-accelerated training - Real-time preview

Video to 4DGS

Convert videos to volumetric 4D Gaussian Splats: - Frame extraction and processing - Temporal consistency - Optimized frame sequences - Manifest generation

Splat Preview

Preview and inspect splat files: - Real-time 3D rendering - Camera controls (orbit, fly, first-person) - File information display - Quick quality assessment

Interface

┌────────────────────────────────────────────────────────┐
│  StorySplat Tools                              [─][□][×]│
├────────────────────────────────────────────────────────┤
│  [Convert] [Image→Splat] [Video→4DGS] [Preview] [⚙]   │
├────────────────────────────────────────────────────────┤
│                                                        │
│                    Main Content Area                   │
│                                                        │
│  ┌──────────────────────────────────────────────────┐ │
│  │                                                  │ │
│  │         Drag & drop files here                   │ │
│  │              or click to browse                  │ │
│  │                                                  │ │
│  └──────────────────────────────────────────────────┘ │
│                                                        │
│  [Process]                               [Export]      │
│                                                        │
├────────────────────────────────────────────────────────┤
│  Status: Ready                                         │
└────────────────────────────────────────────────────────┘

Workflow Examples

Basic Format Conversion

  1. Open Convert tab
  2. Drag in .ply files
  3. Select output format (SOG recommended for web)
  4. Click Convert
  5. Find converted files in output folder

Creating a 3D Scene from Photos

  1. Open Image→Splat tab
  2. Drag in photos (50-200 images recommended)
  3. Configure processing options:
  4. Quality preset (fast/balanced/high)
  5. GPU acceleration
  6. Click Process
  7. Preview result when complete
  8. Export as SOG for web use

Converting Video to 4DGS

  1. Open Video→4DGS tab
  2. Select video file
  3. Configure settings:
  4. Frame rate (24 fps typical)
  5. Output format
  6. Quality settings
  7. Click Process
  8. Upload frames to CDN
  9. Use generated manifest with StorySplat Viewer

System Requirements

Requirement Minimum Recommended
OS Windows 10, macOS 11, Linux Windows 11, macOS 13+, Ubuntu 22+
RAM 8 GB 16 GB+
GPU Any with OpenGL 4.1 NVIDIA RTX series
Storage 10 GB free 50 GB+ SSD
Python 3.10+ 3.11

GPU Acceleration

StorySplat Tools uses GPU acceleration for:

  • Preview rendering: WebGL/WebGPU via PlayCanvas
  • AI processing: CUDA via PyTorch (NVIDIA GPUs)
  • Format conversion: Parallel processing

NVIDIA GPU Setup

  1. Install latest NVIDIA drivers
  2. Launch StorySplat Tools
  3. Check Settings for CUDA status
  4. If needed, click "Reinstall with CUDA"

Non-NVIDIA GPUs

  • AMD/Intel GPUs: Preview works, AI features use CPU
  • Apple Silicon: Metal acceleration for preview, CPU for AI
  • CPU-only: All features work, but slower

File Support

Input Formats

  • Images: JPG, PNG, TIFF, WEBP
  • Video: MP4, MOV, AVI, MKV
  • Splats: PLY, SOG, SPLAT

Output Formats

  • SOG (recommended for web)
  • Compressed PLY
  • Standard PLY
  • Frame sequences (for 4DGS)

Next Steps