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
+5
日增长
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
#50建议在各个主要环节增加并行加速逻辑5 comments · 2026-09-20#24外部进程执行失败3 comments · 2026-08-31#57Localize Brush training logs2 comments · 2026-09-25#28[Bug] Brush/WGPU Vulkan adapter initialization failed (`No possible adapter available for backend`)2 comments · 2026-09-04#91[Bug] macOS 0.8.0:Brush 哈希校验不一致导致强制去畸变,NaN 观测使训练失败1 comments · 2026-11-15#56win11,从来没跑通过1 comments · 2026-09-25#89AI视频无法解析引l擎输出:invalid type:integer'1',expected struct ProbeDocument at line l column 10 comments · 2026-11-12#82[Bug] FFmpeg 正常退出但计划与实际帧数不一致,导致生成中止0 comments · 2026-11-02
Discussions
#92v0.8.10 comments · 2026-11-15#87v0.8.00 comments · 2026-11-12#80v0.7.10 comments · 2026-10-28#75v0.7.00 comments · 2026-10-19#70v0.6.11 comments · 2026-10-12#65v0.6.00 comments · 2026-10-07#60v0.5.00 comments · 2026-09-28#38OOOSplat v0.4.11 comments · 2026-09-13
Latest release
v0.8.1 0.8.1 Pre-release 2026-11-15OOOSplat 0.8.1 中文 | English --- 中文 OOOSplat 0.8.1 主要提升生成稳定性和任务恢复体验,并加入多显卡选择以及横竖拍图片混合输入支持。 ✨ 主要更新 生成与继续生成更可靠 - 改进失败、取消或异常退出后的“继续生成”,尽可能复用已经完成且有效的处理结果。 - 修复部分任务继续生成时,因残留数据库文件而无法启动的问题。 - 减少继续生成时重复准备素材、重复重建或重复训练的情况。 - 改进项目进度保存,降低磁盘错误或异常退出造成任务记录损坏的风险。 - 某个已完成项目的模型文件缺失或损坏时,不再影响其他任务正常显示和使用。 改善相机重建成功率 - 当普通素材首次无法建立相机位置时,会自动尝试其他合适的起始画面。 - 修复有效重建结果被错误结果覆盖的问题。 - 补帧未能改善重建时,可以安全保留补帧前的有效结果。 - 不会为了完成任务而降低匹配要求、删除未注册图片或使用明显异常的相机参数。 训练与补拍修复 - 修复训练结果导出失败后被误认为画质问题,并错误触发重新训练的情况。 - 补拍选择沿用原模型时,继续使用可信的原模型作为起点。 - 补拍切换为重新训练时,不会再意外加载旧模型。 - 继续生成和显存不足重试会保持原任务选择的显卡和生成方式。