Communitygithub.com

gyroflow/gyroflow

使用陀螺仪数据进行视频稳定化。

gyroflow 是什么?

这个技能基于开源项目Gyroflow,利用陀螺仪数据对视频进行运动补偿,实现硬件级别的稳定效果。它支持从GoPro、DJI、Sony等主流运动相机和手机读取嵌入的陀螺仪元数据,或者手动加载外部陀螺仪日志文件。用户可以通过CLI或SDK接口批量处理视频,调整平滑度、裁剪边界等参数,适合专业影视后期、无人机航拍或运动拍摄场景。目前支持Windows、macOS和Linux平台,并能集成到Claude Code、Cursor等AI工具的工作流中,实现自动化视频稳定。

兼容平台~Claude Code~Codex CLI~Cursor
npx skills add gyroflow/gyroflow

在你喜欢的 AI 中提问

打开一个已预加载此 Agent Skill 的新对话。

文档

gyroflow 是做什么的?

使用陀螺仪数据进行视频稳定化。

概述

Gyroflow是一个开源视频稳定工具,它利用相机陀螺仪(或外置陀螺仪)记录的角速度数据,对视频进行运动补偿,从而消除抖动,获得平滑稳定的画面。与纯软件分析不同,它基于真实物理数据,稳定效果更加精准且保留更多原始画质。

支持的平台

  • Windows
  • macOS
  • Linux

功能特性

  • 从GoPro、DJI、Sony等相机直接读取嵌入的陀螺仪元数据
  • 支持加载外部陀螺仪日志文件(.csv、.log等格式)
  • 灵活的参数调整:平滑度、边界裁剪、旋转、缩放等
  • 批量处理多个视频文件
  • CLI命令行和SDK接口,便于集成到自动化流程
  • 支持GPU加速(OpenCL/CUDA)

使用方法

通过CLI工具直接处理视频:

gyroflow -i input.mp4 -o output.mp4 -s profile.json

或者使用Lens配置文件来匹配相机镜头参数:

gyroflow -i input.mp4 --lens my_lens.json

集成到AI工具

在Claude Code、Cursor或Codex中,可以调用Gyroflow的CLI进行视频稳定处理。

示例:

import subprocess

subprocess.run([
    'gyroflow',
    '-i', 'input.mp4',
    '-o', 'output.mp4',
    '--smoothness', '0.5'
])

参考链接

相关技能