FreeMoCap 报错自救指南按报错等级 30 秒定位 10 个高频问题【免费下载链接】freemocapFree Motion Capture for Everyone ✨项目地址: https://gitcode.com/GitHub_Trending/fr/freemocapFreeMoCap 是一套无标记点动作捕捉系统从多机位录像一路走到摄像头校准、2D 跟踪、三角化重建和 Blender 导出。本文按报错严重度汇总了最常见的报错原文、人话翻译与解决方案适合第一次跑流程就撞上红字、想自己动手恢复工作流的新手用户。快速分诊先看哪一级报错关键词典型现象最可能原因跳转Could not find ffmpeg视频同步报错、UI 顶部黄条系统没装 ffmpeg修好缺失的 ffmpegBlender executable not found导出 .blend 无响应Blender 没在默认安装位置指定 Blender 路径No video files found后处理直接失败录制没完成或找错了文件夹找回丢失的视频opencv相关 import 崩溃启动就红字opencv-python 与 contrib 双装依赖冲突一键修复No valid calibration points校准跑到一半异常标定板拍摄不充分让校准一次过Failed to open video file处理中途挂掉视频损坏或被占用找回丢失的视频阻塞级跑不起来修好缺失的 ffmpeg报错原文Could not find ffmpeg and ffprobe on your system PATH - install ffmpeg to enable video synchronization人话FreeMoCap 调不到你系统里的ffmpeg/ffprobe多路视频没法做时间同步。这是环境缺工具不是代码问题。安装 ffmpeg# macOS执行brew install ffmpeg# Linux执行sudo apt install ffmpeg# Windows装 ffmpeg 并加入 PATH。终端跑ffmpeg -version确认版本号出来。重启 FreeMoCap同步即可正常开始。给 Blender 导出指条明确的路报错原文Blender executable not found at: {blender_exe_path}或Blender file was created but is empty at: {blend_file_path}人话它去你填的路径找 Blender 可执行文件没找到或者 Blender 跑完没产出文件——十有八九是路径指错了。在应用设置里手动填 Blender 可执行文件完整路径别依赖自动探测探测逻辑在freemocap/core/blender/helpers/get_best_guess_of_blender_path.py只认少数默认位置。# macOS常见为/Applications/Blender.app/Contents/MacOS/Blender# Windows常见为C:\Program Files\Blender Foundation\Blender\版本\blender.exe用 Blender 官方渠道安装的版本2.93 以上均可。再点一次导出若仍报Blender output file not found检查输出目录可写、磁盘有剩余空间。找回丢失的视频报错原文No video files found in {video_folder_path}或Video file not found: {video_path}人话它去videos/synchronized目录里找 mp4 没找到。先别慌大概率是录制没真正完成或者你选错了录制文件夹。打开~/freemocap_data/recordings/录制名/确认videos/synchronized下确实有.mp4文件扫描逻辑见freemocap/utilities/get_video_paths.py只认 mp4。是空目录 → 回到录制页重新完整录一段别中途关窗。有文件却打不开Failed to open video file→ 视频可能损坏或被其他程序独占换个播放器试播不行就重录。摄像头连不上报错原文No camera groups currently connected人话服务端认为现在没有任何一组摄像头在线实时流程起不来。关掉所有可能占用摄像头的软件视频会议、OBS、其他相机工具。换 USB 口或换线摄像头数量多时优先用 USB 3.0 口并给足供电。# macOS在「系统设置 → 隐私与安全性 → 摄像头」里确认应用有权限。重启 FreeMoCap 再点「连接」仍不行就重启电脑。依赖冲突一键修复报错原文启动或校准时出现cv2相关 import 崩溃、DLL load failedWindows等字样 人话环境里opencv-python和opencv-contrib-python同时装着两个包文件互相打架。这个坑项目内置了修复工具。直接运行内置脚本python -m freemocap.utilities.fix_opencv_conflict脚本会自动卸载两个冲突包并重装opencv-contrib-python4.8.*。若脚本中途失败按它的提示手动执行pip uninstall -y opencv-python opencv-contrib-python然后pip install opencv-contrib-python4.8.*。告警级能跑但结果不对让校准一次过报错原文No valid calibration points for camera 0 (need 7)/No shared observations between cameras 0 and 1/Graph may be disconnected!人话某个摄像头画面里标定板的有效观测点不够少于 7 个或者两个摄像头之间没有任何一帧同时拍到了标定板——标定板没被拍够。先别急着改代码问题在拍摄。重录校准标定板平放、无变形反光覆盖录制空间近中远不同深度并且每块板都要出现在至少两个摄像头画面里。拍摄时长给足别拍一两秒就结束。核对 Charuco 尺寸设置和实物一致设置项见freemocap/core/tasks/calibration/charuco_board/charuco_board_ops.py。重建结果漂移、关节点跳动报错原文没有红字但 3D 骨骼漂移、抖动、整体漂离地面 人话三角化结果不稳最常见的元凶是校准质量或光照而不是调参能救回来的。检查标定板是否平整贴地或贴面、光照是否均匀、板面有没有高光反射。重新录一段校准按上一节步骤再重跑重建。还漂 → 换一组固定好相机的支架重拍素材相机位置动过等于校准作废。体验级慢、卡、警告刷屏实时流卡顿或帧率上不去现象实时视图掉帧、延迟高日志里 GPU 相关 provider 不可用 人话十有八九是装到了 CPU 版的 tracker没吃到显卡加速。确认当前环境装的是 CUDA 版pip show skellytracker看版本与依赖。按显卡重装对应版本pip install freemocap[cuda] # NVIDIA 显卡 pip install freemocap[cpu] # macOS 或无 NVIDIA 显卡相机分辨率适当降一档比如 1080p → 720p再试多路摄像头的总数据量是帧率的第一杀手。在日志里找真正的元凶报错原文Failed to decode JSON message: {e}/Received unexpected message format: {message}人话前端和后端的通信消息格式没对上通常是版本没对齐前端和后端必须是同一套代码构建。打开日志~/freemocap_data/logs_info_and_settings/logs/下最新的log_*.log路径定义见freemocap/system/default_paths.py看最后一段 traceback真正的异常往往在更早几行。记录出错时间点对照 UI 上你当时点的操作。前后端版本不一致时用同一提交重新构建前端freemocap-ui/再配对。提交 Issue 前的自查清单Python 版本 ≥ 3.11pyproject.toml声明了requires-python 3.11用的是干净虚拟环境且装的是 CUDA 或 CPU 二选一、没混装opencv-python与opencv-contrib-python不同时存在ffmpeg / ffprobe 都在 PATH 里录制文件夹命名没手改过时间戳命名videos/synchronized下有 mp4标定板尺寸设置与实物一致每块板被 ≥2 个摄像头拍到磁盘剩余空间 10 GB前端与后端来自同一份代码构建求助模板提 Issue 时请附这些信息系统OS 与版本、Python 版本、FreeMoCap 版本pip show freemocap显卡型号以及装的是freemocap[cuda]还是freemocap[cpu]完整报错原文含 traceback不要只截最后一行复现步骤从启动到出错的每一步操作已尝试的操作跑过哪些命令、改过哪些设置日志~/freemocap_data/logs_info_and_settings/logs/里对应时间段的日志片段把以上内容整理清楚再提交维护者基本可以一次定位。写在最后按「阻塞 → 告警 → 体验」的顺序过一遍绝大多数红字都能自己消掉消不掉的带着上面的自查结果去项目 Issue 区提问。仓库在持续迭代解决前记得看一下最新 commit 与README.md、docs目录确认问题是否已有现成答案。【免费下载链接】freemocapFree Motion Capture for Everyone ✨项目地址: https://gitcode.com/GitHub_Trending/fr/freemocap创作声明：本文部分内容由AI辅助生成（AIGC），仅供参考 FreeMoCap 报错自救指南：按报错等级 30 秒定位 10 个高频问题
FreeMoCap 报错自救指南按报错等级 30 秒定位 10 个高频问题【免费下载链接】freemocapFree Motion Capture for Everyone ✨项目地址: https://gitcode.com/GitHub_Trending/fr/freemocapFreeMoCap 是一套无标记点动作捕捉系统从多机位录像一路走到摄像头校准、2D 跟踪、三角化重建和 Blender 导出。本文按报错严重度汇总了最常见的报错原文、人话翻译与解决方案适合第一次跑流程就撞上红字、想自己动手恢复工作流的新手用户。快速分诊先看哪一级报错关键词典型现象最可能原因跳转Could not find ffmpeg视频同步报错、UI 顶部黄条系统没装 ffmpeg修好缺失的 ffmpegBlender executable not found导出 .blend 无响应Blender 没在默认安装位置指定 Blender 路径No video files found后处理直接失败录制没完成或找错了文件夹找回丢失的视频opencv相关 import 崩溃启动就红字opencv-python 与 contrib 双装依赖冲突一键修复No valid calibration points校准跑到一半异常标定板拍摄不充分让校准一次过Failed to open video file处理中途挂掉视频损坏或被占用找回丢失的视频阻塞级跑不起来修好缺失的 ffmpeg报错原文Could not find ffmpeg and ffprobe on your system PATH - install ffmpeg to enable video synchronization人话FreeMoCap 调不到你系统里的ffmpeg/ffprobe多路视频没法做时间同步。这是环境缺工具不是代码问题。安装 ffmpeg# macOS执行brew install ffmpeg# Linux执行sudo apt install ffmpeg# Windows装 ffmpeg 并加入 PATH。终端跑ffmpeg -version确认版本号出来。重启 FreeMoCap同步即可正常开始。给 Blender 导出指条明确的路报错原文Blender executable not found at: {blender_exe_path}或Blender file was created but is empty at: {blend_file_path}人话它去你填的路径找 Blender 可执行文件没找到或者 Blender 跑完没产出文件——十有八九是路径指错了。在应用设置里手动填 Blender 可执行文件完整路径别依赖自动探测探测逻辑在freemocap/core/blender/helpers/get_best_guess_of_blender_path.py只认少数默认位置。# macOS常见为/Applications/Blender.app/Contents/MacOS/Blender# Windows常见为C:\Program Files\Blender Foundation\Blender\版本\blender.exe用 Blender 官方渠道安装的版本2.93 以上均可。再点一次导出若仍报Blender output file not found检查输出目录可写、磁盘有剩余空间。找回丢失的视频报错原文No video files found in {video_folder_path}或Video file not found: {video_path}人话它去videos/synchronized目录里找 mp4 没找到。先别慌大概率是录制没真正完成或者你选错了录制文件夹。打开~/freemocap_data/recordings/录制名/确认videos/synchronized下确实有.mp4文件扫描逻辑见freemocap/utilities/get_video_paths.py只认 mp4。是空目录 → 回到录制页重新完整录一段别中途关窗。有文件却打不开Failed to open video file→ 视频可能损坏或被其他程序独占换个播放器试播不行就重录。摄像头连不上报错原文No camera groups currently connected人话服务端认为现在没有任何一组摄像头在线实时流程起不来。关掉所有可能占用摄像头的软件视频会议、OBS、其他相机工具。换 USB 口或换线摄像头数量多时优先用 USB 3.0 口并给足供电。# macOS在「系统设置 → 隐私与安全性 → 摄像头」里确认应用有权限。重启 FreeMoCap 再点「连接」仍不行就重启电脑。依赖冲突一键修复报错原文启动或校准时出现cv2相关 import 崩溃、DLL load failedWindows等字样 人话环境里opencv-python和opencv-contrib-python同时装着两个包文件互相打架。这个坑项目内置了修复工具。直接运行内置脚本python -m freemocap.utilities.fix_opencv_conflict脚本会自动卸载两个冲突包并重装opencv-contrib-python4.8.*。若脚本中途失败按它的提示手动执行pip uninstall -y opencv-python opencv-contrib-python然后pip install opencv-contrib-python4.8.*。告警级能跑但结果不对让校准一次过报错原文No valid calibration points for camera 0 (need 7)/No shared observations between cameras 0 and 1/Graph may be disconnected!人话某个摄像头画面里标定板的有效观测点不够少于 7 个或者两个摄像头之间没有任何一帧同时拍到了标定板——标定板没被拍够。先别急着改代码问题在拍摄。重录校准标定板平放、无变形反光覆盖录制空间近中远不同深度并且每块板都要出现在至少两个摄像头画面里。拍摄时长给足别拍一两秒就结束。核对 Charuco 尺寸设置和实物一致设置项见freemocap/core/tasks/calibration/charuco_board/charuco_board_ops.py。重建结果漂移、关节点跳动报错原文没有红字但 3D 骨骼漂移、抖动、整体漂离地面 人话三角化结果不稳最常见的元凶是校准质量或光照而不是调参能救回来的。检查标定板是否平整贴地或贴面、光照是否均匀、板面有没有高光反射。重新录一段校准按上一节步骤再重跑重建。还漂 → 换一组固定好相机的支架重拍素材相机位置动过等于校准作废。体验级慢、卡、警告刷屏实时流卡顿或帧率上不去现象实时视图掉帧、延迟高日志里 GPU 相关 provider 不可用 人话十有八九是装到了 CPU 版的 tracker没吃到显卡加速。确认当前环境装的是 CUDA 版pip show skellytracker看版本与依赖。按显卡重装对应版本pip install freemocap[cuda] # NVIDIA 显卡 pip install freemocap[cpu] # macOS 或无 NVIDIA 显卡相机分辨率适当降一档比如 1080p → 720p再试多路摄像头的总数据量是帧率的第一杀手。在日志里找真正的元凶报错原文Failed to decode JSON message: {e}/Received unexpected message format: {message}人话前端和后端的通信消息格式没对上通常是版本没对齐前端和后端必须是同一套代码构建。打开日志~/freemocap_data/logs_info_and_settings/logs/下最新的log_*.log路径定义见freemocap/system/default_paths.py看最后一段 traceback真正的异常往往在更早几行。记录出错时间点对照 UI 上你当时点的操作。前后端版本不一致时用同一提交重新构建前端freemocap-ui/再配对。提交 Issue 前的自查清单Python 版本 ≥ 3.11pyproject.toml声明了requires-python 3.11用的是干净虚拟环境且装的是 CUDA 或 CPU 二选一、没混装opencv-python与opencv-contrib-python不同时存在ffmpeg / ffprobe 都在 PATH 里录制文件夹命名没手改过时间戳命名videos/synchronized下有 mp4标定板尺寸设置与实物一致每块板被 ≥2 个摄像头拍到磁盘剩余空间 10 GB前端与后端来自同一份代码构建求助模板提 Issue 时请附这些信息系统OS 与版本、Python 版本、FreeMoCap 版本pip show freemocap显卡型号以及装的是freemocap[cuda]还是freemocap[cpu]完整报错原文含 traceback不要只截最后一行复现步骤从启动到出错的每一步操作已尝试的操作跑过哪些命令、改过哪些设置日志~/freemocap_data/logs_info_and_settings/logs/里对应时间段的日志片段把以上内容整理清楚再提交维护者基本可以一次定位。写在最后按「阻塞 → 告警 → 体验」的顺序过一遍绝大多数红字都能自己消掉消不掉的带着上面的自查结果去项目 Issue 区提问。仓库在持续迭代解决前记得看一下最新 commit 与README.md、docs目录确认问题是否已有现成答案。【免费下载链接】freemocapFree Motion Capture for Everyone ✨项目地址: https://gitcode.com/GitHub_Trending/fr/freemocap创作声明：本文部分内容由AI辅助生成（AIGC），仅供参考