ooolabdev /ooosplat

A local desktop app that turns videos and images into 3D Gaussian Splats in one click.

★ 2,518⑂ 302👁 11⑃ 31● 51▤ 12
RustApache-2.0Created 2026-08-15
Download: v0.8.1v0.8.1 ↓0.8.12026-11-15
+5
Daily
2,518
stars
302
forks
11
watchers
31
prs
51
issues
12
releases

README

OOOSplat


  
  
  



  下载 | 中文 | English | 日本語



  
  


OOOSplat 是一款将普通或全景视频、图片序列一键转换为 3D Gaussian Splatting 的本地桌面应用。选择素材、项目目录和质量档位,即可自动完成生成,并直接预览、编辑和导出结果。

Windows 和 Apple Silicon macOS Alpha 均随应用提供 FFmpeg、FFprobe、COLMAP 和 Brush;Linux 支持目前仅作为 Ubuntu 24.04 LTS x86_64 Alpha 提供。整个生成流程使用本机 CPU 和 GPU,输入素材、工程文件、模型与日志无需上传到云端重建或训练服务。

查看 OOOSplat Roadmap 了解后续规划。

 0.8.1 提升生成与继续生成的可靠性,支持多显卡选择及同规格横竖拍图片混合输入,并改进 COLMAP、Brush、FFprobe 与跨平台运行诊断。

 核心优势

- 一键生成高斯泼溅:只需选择输入视频或图片序列、项目目录和质量档位,即可自动完成画面准备、COLMAP 相机重建、Brush 训练和 final.ply 发布,无需手动拼接命令或配置引擎。
- 简单易上手:无需了解高斯泼溅专业参数;OOOSplat 会依据设备能力、素材类型和分辨率自动设置适用的抽帧、重建与训练参数,按照界面提示选择素材、项目目录和质量档位即可开始生成。
- 跨平台支持:支持 Windows,并提供 Apple Silicon macOS Alpha 和 Ubuntu 24.04 x86_64 Alpha;具体系统与处理器要求请参阅下方兼容性说明。
- 完全本地化算力:重建与训练均在用户自己的电脑上运行,不调用远程计算服务。满足要求时 COLMAP 自动使用本机 NVIDIA GPU 加速,否则回退 CPU,过程和数据始终由用户掌控。

 展示视频

https://github.com/user-attachments/assets/5b9e8cef-4c71-4bfa-ba23-641fcdd37659

 界面预览

 创建与管理任务

!OOOSplat 创建新任务与任务列表界面

 高斯泼溅预览与调整

!OOOSplat 高斯泼溅预览与 Transform 调整界面

 主要功能

- 统一素材输入:选择或拖入多段 MP4、MOV、多个图片文件夹或 JPG、JPEG、PNG 散图集,在同一输入框内逐项检测、确认类型和删除,联合重建同一场景;同一普通图片集可混合像素规格一致的横拍与竖拍图片,并按方向使用独立相机组。
- 全景素材:支持已拼接、单目、完整 360°×180° 的 2:1 ERP MP4 和图片文件夹;自动检测类型,无法确定时在素材框中选择。
- 图片顺序确认:每个图片集超过100张时,在素材框内分别选择拍摄顺序;已排序使用顺序匹配,未排序或100张及以下使用穷举匹配。
- 图片 GPS:识别内嵌定位信息,在通过校验的 Windows x64 路径中辅助匹配与重建,可靠时提供北向与米制尺度;信息不足自动沿用原流程。范围及验证
- 导入外部模型:可从“已完成”分组导入标准/压缩 PLY、SOG、SPZ、SPLAT 和 KSPLAT,用于预览、编辑和导出;新导入不再关联附带的 COLMAP,外部文件保持只读。
- 三种质量档位:默认启用重建优化与自动补帧;快速/均衡/精细默认保留6/8/12 FPS,高级设置可按视频调整抽帧后的帧率,各段独立规划,手动调整后每段最多额外补20%。普通素材的 Splat 上限使用有效像素公式,三档系数为0.2/0.4/0.5;全景保留独立预算,精细档按权威重建稀疏点数×40。精细档保留原始训练分辨率。
- 自动重试:默认开启,允许显存不足后减少点数重试或调整补拍方案;可关闭,实际重试后在完成详情标记。
- 透明素材:支持透明 MOV 和 PNG,保留原始颜色与 Alpha;普通透明图片为 SfM 单独生成 Alpha 预乘 RGB 和灰度 Mask,训练仍使用原 RGBA。
- 多任务管理:保存、排序草稿并自动执行后续任务,同一时间只运行一个生成任务。失败、取消和中断统一使用“继续生成”,复用有效成果并保留原配方、实际路线及已消耗次数;主动继续会关闭自动队列,只执行当前任务。
- 补拍:根据原模型情况及每个普通来源的拍摄设置选择处理方式,支持多来源、跨尺寸及普通/完整 ERP 混合补拍;冻结原项目快照并复用普通生成流程,在独立派生项目中使用正常完整训练配方。
- 预览与编辑:支持 WebGPU/WebGL2、移动轴与旋转环、裁切、删点、反选和撤销重做;静止画面停止重绘,交互最高60 FPS。支持0.1×–5.0× WASD 鼠标转向漫游(W/S 沿视线前后移动,A/D 水平侧移)与首帧训练视角定位。
- 多种导出:支持标准 PLY、压缩 PLY、SPZ v4、单文件 SOG,以及竖屏或横屏 MP4、单文件离线 HTML。SPZ 坐标越界时,经确认可仅调整导出副本。
- 本地运行:COLMAP 重建与 Brush 训练都在本机完成;满足条件时自动使用 GPU,否则使用可用的兼容路径。

 Gaussian 编辑快捷键

- 矩形选择时,左键拖动替换选区,Shift + 左键拖动添加,Ctrl + 左键拖动移除;中键旋转视角,右键平移,滚轮缩放。
- 黄色高亮表示当前选区;按 Delete 或 Backspace 删除选中 Gaussian,按 Esc 清空临时选区。
- 在矩形、球形或盒形选择中,点击“反选”或按 Ctrl + I(macOS 为 ⌘ + I)切换保留或选中的部分。
- 球形或盒形选择会自动进入正交视图,可切换侧视图、正视图和顶视图,并通过视口控制器或数值面板调整位置与大小。
- 变换面板中的“场景操作轴”可切换“移动/旋转”,再次点击当前选中的按钮即可关闭;左键拖轴操作模型,拖动空白处转动视角。旋转环和面板旋转都围绕模型中心;松开提交一次编辑,Esc 取消本次拖轴,操作轴模式保存在本机。
- 按住 WASD 漫游并锁定鼠标转向:W/S 沿视线前后移动,抬头按 W 上升、低头按 W 下降,A/D 保持水平侧移;松开按键恢复光标,Esc 退出,Shift 三倍加速。不支持鼠标锁定时保留原有拖动操作。右下角支持0.1×–5.0×调速并记住本机设置,速度随缩放调整,仅透视视图可用。
- Ctrl + Z 撤销,Ctrl + Shift + Z 或 Ctrl + Y 重做。模型变换、裁切和删除共享同一历史记录;相机移动和临时黄色选区不计入历史。

 处理流程

text
输入视频或图片集
  │
  ├─ 视频:FFprobe 分析,各段按独立目标保留帧率和工作分辨率抽帧;透明视频同步生成 RGBA 画面与 Mask
  ├─ 图片:文件头检测及自然排序,按需规范化方向;工作 RGB、Alpha、Mask 对齐
  ├─ COLMAP:自动选择 CPU 或 CUDA GPU 提取特征;视频顺序匹配,图片默认穷举匹配,超过100张可确认按

Top issues

Discussions

Latest release

v0.8.1 0.8.1 Pre-release 2026-11-15
OOOSplat 0.8.1

中文 | English

---

 中文

OOOSplat 0.8.1 主要提升生成稳定性和任务恢复体验,并加入多显卡选择以及横竖拍图片混合输入支持。

 ✨ 主要更新

 生成与继续生成更可靠

- 改进失败、取消或异常退出后的“继续生成”,尽可能复用已经完成且有效的处理结果。
- 修复部分任务继续生成时,因残留数据库文件而无法启动的问题。
- 减少继续生成时重复准备素材、重复重建或重复训练的情况。
- 改进项目进度保存,降低磁盘错误或异常退出造成任务记录损坏的风险。
- 某个已完成项目的模型文件缺失或损坏时,不再影响其他任务正常显示和使用。

 改善相机重建成功率

- 当普通素材首次无法建立相机位置时,会自动尝试其他合适的起始画面。
- 修复有效重建结果被错误结果覆盖的问题。
- 补帧未能改善重建时,可以安全保留补帧前的有效结果。
- 不会为了完成任务而降低匹配要求、删除未注册图片或使用明显异常的相机参数。

 训练与补拍修复

- 修复训练结果导出失败后被误认为画质问题,并错误触发重新训练的情况。
- 补拍选择沿用原模型时,继续使用可信的原模型作为起点。
- 补拍切换为重新训练时,不会再意外加载旧模型。
- 继续生成和显存不足重试会保持原任务选择的显卡和生成方式。

 

Snapshot: 2026-11-16T09:23:14Z · Data license Apache-2.0 · JSON