Action Footage Player
中文

本页由英文原文机器翻译而成,可能存在不准确之处。 阅读英文原文

参考 · 全部功能

全部功能

Action Footage Player 能做什么,按类别列出:每项功能一两句话说明,附上快捷键,以及目前试用到了什么程度。

早期 Alpha 版 截至 2026 年 11 月 GPL-3.0

已验证 已在 Mac 上的 App 中用真实素材播放过 应可用 已根据厂商公开的元数据或样片实现,但尚未用真实素材试过 尚不支持 目前还不能用

打开片段

无需导入,没有媒体库,也不必先渲染:片段在哪里,就在哪里播放。

双击片段

Mac App 的设置会把它设为 MP4 视频的默认 App(macOS 会请你确认):双击 MP4 即可播放,本页的所有功能都会生效。其他视频可以通过访达的“打开方式”用它打开。

访达的快速操作

macOS

右键 → 快速操作:Play Stabilized 在播放器中打开所选视频;Stabilize + LUT 在后台导出它们,每完成一个都会发出通知。

文件资源管理器的菜单

Windows

MP4 和 MOV 视频的“打开方式”中有 ActionFootagePlayer,文件资源管理器的菜单中有 Play in ActionFootagePlayer 和 Stabilize + LUT,后者在单独的窗口中导出并显示进度(Windows 11 上在“显示更多选项”里)。

一个窗口,整个文件夹

播放时再打开一个视频,它会取代当前视频。文件夹中的其他视频就是上一个和下一个片段,在侧边面板的 Clip 中。

片段的信息

面板 → Clip

侧边面板的 Clip 中显示:相机型号、Log 曲线、是否有运动数据和遥测数据,以及有几个精彩时刻。

原始文件保持原样

你的原始文件保持原样,除非你剪掉其中拍坏的一段:这时片段会被重写,去掉这一段,不重新编码,原始文件则移到废纸篓。Gyroflow 项目是片段旁边的 .gyroflow 文件,你的标记也放在片段旁边;精彩瞬间和导出的文件放在项目文件夹里。

直接来自相机

播放从存储卡上原样拷贝的片段。经过其他 App 导出或裁剪的片段会丢失播放器读取的元数据:Log 模式、运动数据、遥测数据和精彩时刻。

Log 色彩与风格

Log 是相机记录信息最多的模式,但片段看起来又平又灰,通常需要调色。在这里,它们直接以完整色彩播放。

Log 素材,一步步讲清楚 →

自动识别 Log

判断是否为 Log 依据的是片段的元数据,而不是文件名,所以无需任何设置:Osmo Action 6 和 Osmo 360 的 D-Log M,近期 GoPro 的 GP-Log 和 GP-Log2。普通片段照常播放。

已验证 Osmo Action 6(D-Log M);GoPro HERO12 Black(GP-Log,固件 1.20 或更高) 应可用 Osmo 360;HERO13 Black;GP-Log2(MISSION 1)

以 HDR 播放 Log

Ctrl+h

D-Log M、D-Log、GP-Log、GP-Log2 和 10-bit I-Log 会被转换为 HDR(Rec.2100 HLG):这是固定的技术性转换,所有片段都一样,不添加任何创意风格。Ctrl+h 直接切换到 HDR。

手动选择 Log 曲线

Ctrl+l

适用于元数据中没有注明的片段:依次切换 D-Log M、D-Log、GP-Log、GP-Log2 和 I-Log(10-bit),均以 HDR 显示。

应可用 Insta360 单镜头,10-bit I-Log 尚不支持 8-bit I-Log

SDR 风格

Ctrl+s

SDR:经 NBCUniversal 中性的 HLG → SDR 转换(所有相机都一样),经相机厂商自己的 Rec.709 LUT(D-Log M 用 DJI 的),或由 mpv 色调映射。Ctrl+s 会在它们和 HDR 输出之间依次切换。

尚不支持 D-Log M 以外曲线的厂商 Rec.709 LUT

DJI 的 LUT,从 DJI 获取

DJI 的 Rec.709 LUT 不随本项目分发:App 的设置会从 DJI 下载并校验它。HDR 和 NBCU 的 SDR 不需要它。

按录制原样

L

对当前片段关闭 Log 处理:文件原样显示,就像相机录下的那样平淡。

HDR 文件原样播放

标记为 HDR 的文件(导出的文件,手机或运动相机拍的 HDR 视频)以 HDR 播放,不套用 LUT,也绝不会被当作 Log 再调一次色。Ctrl+s 以 SDR 显示它,经 NBCU 的转换或由 mpv 色调映射;播放器自己导出的 Dolby Vision 文件,还可以用它们自带的 trim 参数显示。

任何屏幕上的 HDR

在 HDR 屏幕上,Log 只需要技术性转换,每个片段都一样,所以可以自动完成。在没有 HDR 屏幕的 Mac 上,由 macOS 针对该屏幕对 HDR 做色调映射,并用上每一帧自己的亮度信息。

HDR、SDR 和 Dolby Vision,一步步讲清楚 →

片段的起始输出

在 HDR 屏幕上(例如 MacBook Pro 的屏幕),Log 片段以 HDR 开始播放。在没有 HDR 屏幕的 Mac 上(MacBook Air,大多数外接显示器),Mac App 让片段以 HDR, HLG+DV 开始播放:HLG 通过 macOS 自带的 Dolby Vision® 显示管理呈现,由它针对该屏幕做色调映射,与 QuickTime 和 Apple 设备显示导出文件的方式相同。你用 Ctrl+s 选择的输出,就是本次会话中后续片段在同类屏幕上的起始输出。

视频输出

Ctrl+s

切换到片段的下一种视频输出(只在片段具备的输出之间切换):

  • HDR, HLG:HDR;在没有 HDR 的屏幕上,由 macOS 做色调映射;
  • HDR, HLG+DV:在 HDR 屏幕上是 HDR,在没有 HDR 的屏幕上由 trim 参数做色调映射;
  • SDR, HLG+DV:在 HDR 屏幕上也由 trim 参数做色调映射,也就是 SDR 屏幕上看到的样子;
  • SDR:由 mpv 色调映射,经 NBCUniversal 中性的 HLG → SDR 转换,或经相机厂商自己的 Rec.709 LUT(D-Log M 用 DJI 的)。

在 HDR 屏幕上,这些 SDR 输出会以 SDR 屏幕上的样子显示。

Mac App 两种 HLG+DV 输出

每一帧自己的亮度

Mac App

使用 HLG+DV 时,每一帧的最暗、平均和最亮亮度会随帧一起送出(Dolby Vision 的 L1),在播放时由 GPU 测得,因此 macOS 会按每个场景的实际内容做映射,而不是按一个典型场景:昏暗的潜水画面和阳光下的海滩各有各的空间。以 HLG+DV 风格导出的文件,也以同样的方式测量每一帧。

trim 参数:作者的,或中性的

Mac App

trim 参数叠加在每帧的亮度之上:作者按个人喜好设定,贴合 NBCUniversal 的 HLG → SDR 转换,且没有场景级偏移,所以 HDR 屏幕上看到的仍是 HDR。侧边面板的 Dolby Vision 中有对应的滑块,并可以恢复为作者的设定或中性设定(Dolby Vision 自身的映射,不加任何调整)。以 HLG+DV 风格导出的文件采用那里的设置。

面向 Apple 设备的导出文件

Mac App

以 HLG+DV 风格导出时(也就是 Mac App 在没有 HDR 的屏幕上的起始风格),片段会成为 HEVC Main10 HLG,并带有 Dolby Vision Profile 8.4 元数据:播放器自行写入兼容的元数据(RPU)。Apple 设备(iPhone 或 Mac)以 HDR 播放它,在标准屏幕上则应用 trim 参数,因此显示效果与播放器中一致。不支持 Dolby Vision 的设备会把它当作普通的 HLG 播放,并自行做色调映射。

以 HDR, HLG 导出的文件,以及 Stabilize + LUT 和命令行导出的文件,都是普通的 HLG。在 Windows 或 Linux 上导出的文件从不带 Dolby Vision。

另一类屏幕

片段的窗口移到另一类屏幕时,片段保持原来的风格。在 Windows 和 Linux 上,所有屏幕都视为 HDR。

显示器显得太暗

macOS

连接过 HDR 显示设备(例如 HDR 电视)之后,在 Mac 重启之前,macOS 可能会把接在它原来位置上的 SDR 显示器上的 HDR 显示得暗大约一档。播放器发现这种情况时会提示你,就在 HDR 第一次在这种显示器上播放的时候。

防抖

使用 Gyroflow 的引擎,在片段播放的同时进行,与 Log 转换同步:无需先渲染。

防抖,一步步讲清楚 →

基于相机自己的运动数据

Ctrl+g

关闭相机防抖录制的片段,无需项目即可防抖播放:DJI 需关闭 EIS 并使用 Wide 视角(只有这样它才会记录自身的运动),GoPro 关闭 HyperSmooth,Insta360 关闭 FlowState。前提是相机记录了防抖已关闭:相机已经防抖过的片段按原样播放。

已验证 Osmo Action 6(关闭 EIS);GoPro HERO12 Black(关闭 HyperSmooth) 应可用 Osmo 360;其他 DJI 相机;其他 GoPro;Insta360 单镜头 尚不支持 其他相机,在没有项目的情况下

无需预先渲染

以前旅行的素材直接以防抖效果播放,不需要为每个片段渲染并保存一份副本:只有你导出的段落才会写出文件。

防抖本身来自 Gyroflow 的引擎;播放器在此之上加入实时播放、Log 转 HDR 和遥测数据。

开启、更宽、关闭

Ctrl+g

防抖开启 → 开启并使用更宽视角 → 关闭。更宽视角不放大:防抖后的画面在窗口中覆盖的面积与原画面大致相同,边缘有时会露出,并被填充。开启(On)和更宽(Wider)会沿用到后续没有项目的片段;关闭(Off)只对当前片段有效。有项目的片段以开启状态开始,与 Gyroflow 中的设定一致。

防抖强度

Ctrl+k

弱、中或强,适用于没有项目的片段:裁切 10、20 或 30 %,平滑度 50、75 或 100 %。播放中即可切换,并沿用到后续片段。

地平线

面板 → Stabilization

As preset(按预设;有项目的片段则为 As project,按项目)、Level(保持水平)或 Free(不锁定)。Level 需要更多放大,所以边缘露出得更多。

Gyroflow 项目

在 Gyroflow 中制作并保存在片段旁边的项目会被原样使用:片段按项目设定播放,包括其中的地平线锁定和镜头设置。

已验证 Osmo Action 6 应可用 其他相机,以及 Gyroflow 支持的任何相机

在 Gyroflow 中打开

Ctrl+e

暂停播放,并在 Gyroflow 中打开片段的项目;如果还没有项目,会先根据你看到的效果在片段旁边写入一个:同样的镜头、平滑、放大和折射。每次在 Gyroflow 中保存,这里的防抖都会在同一位置重新加载。已存在的项目绝不会被覆盖。

Windows 没有项目的片段需要在 gyroflow.conf 中设置 gyroflow_appLinux PATH 中要有 gyroflow,或者设置 gyroflow_app

没有运动数据?用 Gyroflow

Ctrl+e

播放器自己无法防抖的片段,会原样在 Gyroflow 中打开。没有运动数据的片段(开着 EIS 的 DJI,或根本不记录运动数据的相机)在那里从画面本身进行防抖(光流);开着相机防抖拍摄的 GoPro 或 Insta360 片段带有运动数据,Gyroflow 会加载它。在那里保存项目后,片段就会用它防抖播放。侧边面板中对应的是 Stabilize in Gyroflow…

水下

相机内置防抖在水下会失效(经测试,DJI 的 EIS 如此),很可能是因为水会折射光线,镜头的表现就像一支比它所调校的焦距更长的镜头。关掉它,片段在这里就能稳定播放:默认预设专为水下素材制作,并校正了水对光线的折射。在一段测试片段上,帧间抖动从 0.16 px 降到了 0.02 px。

镜头在水中或水外

Ctrl+u

切换为镜头在水上,再切回水下。默认情况下,折射会在整段片段中跟随相机记录的 In water / Out of water,在一帧之内切换。其他相机的片段按项目或预设播放(默认为水下)。

跟随相机:仅 Osmo Action 6,它是唯一记录这一信息的相机。

边缘填充

Ctrl+b · 面板 → Performance & Quality

防抖后画面未覆盖的区域用什么填充,经过模糊并融合进画面:

  • Trail by direction(按方向留下的轨迹),默认:在真实世界中这个方向上最后一次看到的内容,所以平移镜头时也能与画面吻合;尚未看到过的地方,用周围的颜色向内扩散;
  • Frame's edge spread out(画面边缘向外扩散):只用画面自身的颜色,从边缘向外扩散;
  • Background color(背景色):项目的背景色,与 Gyroflow 渲染的一样。

立即开始播放

没有项目的片段读完开头几秒的运动数据就开始播放,其余部分边播边读:从 NAS 播放约一秒即可开始,而先读完全部数据需要 5-10 秒。

在较慢的电脑上

面板 → Performance & Quality

当防抖持续掉帧超过 2 秒时,播放会暂停,并建议降低帧率、分辨率或边缘填充,或者让水下的色边保持录制原样。侧边面板的 Performance & Quality 中可以设置这些。

遥测数据

相机测得的数据,叠加在视频上,在片段打开时从中读取。

屏幕显示

Ctrl+t

片段有哪项数据就显示哪项:DJI 片段显示深度和 In water / Out of water;GoPro 片段在 GPS 定位后显示位置和速度,没有 GPS 的则显示曝光。Ctrl+t 关闭或打开显示,并沿用到后续片段。

已验证 Osmo Action 6 在水中的深度 应可用 它的其他字段(尚未见过 GPS 定位);Osmo 360;GoPro 的 GPS、速度和曝光 尚不支持 其他相机

深度

在水下,来自气压计,精度 0.1 m,大约每秒一次。在潜水壳中不会记录深度(气压计测的是壳内的空气),但 In water 仍会显示,依据的是画面。

更多字段

面板 → Telemetry

按需显示:气压,水上的海拔(相对值,仅供粗略参考),曝光(ISO、快门、光圈、白平衡),以及 Osmo 360 的图像传感器温度和配对设备的心率。

位置与单位

视频的任意一角(默认左下角),公制或英制(英尺、mph、°F),可在菜单或侧边面板中设置。

精彩时刻与选段

相机的精彩时刻

Ctrl+] / Ctrl+[

录制时按下相机的精彩时刻按键:标记会显示在进度条上,快捷键可跳到下一个或上一个,落在标记前两秒处,因为按下按键时,那一刻通常已经发生了。Page Up / Page Down 跳到标记本身。

已验证 DJI Osmo Action 6(快捷切换按键,或 GPS 蓝牙遥控器) 应可用 DJI Osmo Action 4 和 Action 5 Pro;GoPro HERO5 及更新机型(HiLight 按键、“GoPro, HiLight”语音指令或遥控器) Osmo 360 和 Pocket 3 不会标记精彩时刻。

全部精彩时刻,按时间排列

面板 → Clip

侧边面板的 Clip 中有全部精彩时刻;没有面板时,插件菜单会按时间列出它们。

标记一段

按两次 l

在这一段的开头和结尾各按一次(mpv 的 A-B 循环):随后 Shift+E 导出的就是这一段,k 则把它保存为精彩瞬间。

精彩瞬间、标记与项目

你从一次旅行中留下的东西,都是它文件夹里的普通文件:访达能直接显示文件资源管理器能直接显示,剪辑软件能直接导入。从存储卡到剪辑的完整故事:精彩瞬间与标记。

项目、精彩瞬间与标记,一步步讲清楚 →

保存精彩瞬间

k

按两次 l 标记一段,再按 k,播放器先询问名称,再把这一段保存为精彩瞬间。输入框是空的,旁边显示一个建议名称:Enter 采用它,直接输入则替换它,Esc 取消。没有起名的精彩瞬间以它的日期和时间命名。

一个精彩瞬间就是一个小文件

每个精彩瞬间都是项目 _Moments/ 文件夹里的一个小 MP4,以它的名称命名:<name>.afplink.mp4。访达的缩略图和快速查看文件资源管理器的缩略图和预览窗格(Alt+P)都以正常色彩显示它,而不是 Log 的灰色。在播放器中打开,它会以完整画质播放原始文件中的这一段,防抖效果与你保存时一样。

它的图标是其中的第一个标记,没有标记时则是中间那一帧。文件日期就是这一刻真实发生的时间,所以按日期排序时,精彩瞬间会按发生的先后排列。

像普通文件一样整理

删掉文件,就删掉了这个精彩瞬间。_Moments/ 里的子文件夹由你安排,用来给精彩瞬间分类;重命名文件,就重命名了精彩瞬间。

标记

M

片段中的时间点,显示在进度条上。M 在视频当前位置添加一个标记;在标记上按则删除它。在你改动任何一个之前,标记就是相机的精彩时刻:第一次改动会把它们全部保存到这个片段专属的小标记文件 <clip>.marks.json 中。删掉这个文件,相机的标记就回来了。

整个旅程一目了然

面板 → Project

在你需要时生成:在侧边面板的 Project 标签页中点 Make clip previews(生成片段预览),就会得到一个 _Clips/ 文件夹,每个片段一个小 MP4,即该片段的彩色翻页预览。在图标视图中,这个文件夹就是彩色的整个旅程,不再是一片 Log 的灰色;快速查看几秒钟就能翻完一个片段。在大图标视图中,这个文件夹就是彩色的整个旅程,不再是一片 Log 的灰色;预览窗格(Alt+P)几秒钟就能翻完一个片段。

把片段放到一边

X

不感兴趣:在播放器里按 X,或者从 _Clips/ 删掉这个片段的翻页预览,两者效果相同。片段本身原地不动。

收藏与评分 即将推出

K

还在的精彩瞬间或片段翻页预览就是保留的,删掉的就是不要的。K 把正在播放的精彩瞬间(没有时则是当前片段)设为收藏,再按一次取消:在访达中是绿色的 Favorite 标签在文件资源管理器中是 4 星及以上评分。剪辑软件也会收到这些信息。

剪掉拍坏的一段

Ctrl+x

按两次 l 标记这一段,按 Ctrl+x 并确认。片段会被重写,去掉这一段,不重新编码:保留的部分按原样复制,并在替换任何文件之前先做检查。如果这一段在中间,会留下两个片段;第二个从剪切终点处或之前的关键帧开始,所以拍坏的部分最多可能留下约一秒。

原始文件连同它的标记文件、Gyroflow 项目和片段预览一起移到废纸篓。标记和精彩瞬间会转到新的片段上;导出的文件不受影响。播放器中无法撤销。不需要项目。

DJI 片段;GoPro 片段在检查通过时可以。不支持 Insta360 或 iPhone 片段、精彩瞬间、片段预览或导出的文件。

项目文件夹

面板 → Project

项目就是一次旅行的文件夹,只需设置一次:第一次保存精彩瞬间、导出或生成片段预览时,侧边面板的 Project 标签页会问你用哪个文件夹,是片段所在的文件夹还是它上面的某一层,然后 Initialize the project here(在此初始化项目)会创建项目。其中的每个文件夹都属于这个项目。里面放着 _Moments/、_Clips/ 和 _Exports/,以及存放播放器自己笔记的 _ActionFootagePlayer/。标记和 Gyroflow 项目留在各自的片段旁边。当那个文件夹无法写入时(锁定的存储卡、只读的共享文件夹),播放器会询问一个名称,在“文稿”中它自己的文件夹里(Documents/ActionFootagePlayer/)新建一个项目文件夹,其中的 Sources.txt 指向素材所在的位置。 即将推出

你的原始文件保持原样,除非你剪掉其中拍坏的一段。

导出与分享

每种风格导出什么,一步步讲清楚 →

所见即所导

Shift+E

按片段正在播放的样子一次导出:防抖与否、同样的视角、边缘、地平线和镜头,同样的风格。标记了一段时,只导出这一段。对正在导出的片段按两次 Shift+E 可取消导出。

已验证 Osmo Action 6 的 HDR 导出 应可用 Rec.709 导出;其他相机(Gyroflow 支持的任何相机:需要项目)

适合手机的文件

Log 片段导出为 HDR 的 10-bit HEVC(Rec.2100 HLG),并带有相应的标签,让 macOS、iOS 和 YouTube 以 HDR 显示。在 Mac 上以 HLG+DV 风格导出时,还带有供 Apple 设备使用的 Dolby Vision 元数据(见任何屏幕上的 HDR)。NBCU 和相机厂商的 SDR 风格则导出 Rec.709,侧边面板 Clip 中的 Export in SDR 也是如此,无论当前播放的是什么。由 mpv 色调映射的 SDR 导出为 HLG,SDR, HLG+DV 导出为带 Dolby Vision 的 HLG。10-bit 素材始终保持 10-bit。

文件存放位置

项目的 _Exports/ 文件夹,文件名是你在与精彩瞬间相同的对话框中起的名字;除非导出的是 HDR, HLG,否则风格会写在括号里:Turtle.mov、Turtle (SDR).mov、Turtle (Dolby Vision).mov。文件带有指向原始文件的链接:没有侧边面板时,右键菜单中的 Open the original 会播放原始片段中的这一段。音频原样复制,文件保留片段的日期。通知会告诉你文件的位置,侧边面板的 Clip 可以在访达文件资源管理器中显示最近一次导出的文件。

导出时照常观看

导出期间播放继续进行,进度显示在右上角;可以同时导出多个片段。在 Mac 上,视频播放时导出以后台优先级运行,几乎停止:暂停后,导出就全速进行。

一次导出多个片段

Stabilize + LUT(位于访达的快速操作文件资源管理器的右键菜单中)会导出所选视频,Log 导出为 HDR(HLG),放进项目的 _Exports/ 文件夹;没有项目时,放进片段旁边的 stabilized/ 文件夹。命令行也可以,还能写出供剪辑用的 ProRes 422 HQ。

在 Windows 上

Windows

导出使用 NVENC、Quick Sync 和 AMF 中第一个可用的编码器,否则用处理器上的 x265(慢得多;在 Windows on ARM 上总是如此)。

送到剪辑软件 即将推出

选好之后,精彩瞬间和标记就会送到你的剪辑软件,作用于原始文件:导入一次,无需渲染。

送到剪辑软件,一步步讲清楚 →

给剪辑软件的标记

菜单 → Marks for the editor

选择剪辑软件,播放器就会把这次旅行的文件写到项目文件夹中,以项目名称命名,并告诉你它在哪里。文件包含你没有放到一边的所有片段,或者只包含有精彩瞬间或标记的片段。精彩瞬间的文件夹变成素材箱,访达标签变成关键词,收藏仍是收藏。精彩瞬间的文件夹变成素材箱,收藏仍是收藏。时间按片段自身的时间码计算,所以每个标记点都落在它对应的那一帧上。

Final Cut Pro

一个包含片段的事件,标记作为标记点;精彩瞬间作为关键词范围,带有收藏和拒绝;另有一个把精彩瞬间依次排列的项目。

FCPXML 1.10:文件 → 导入 → XML。

DaVinci Resolve

免费版也可以

基于原始文件的时间线:精彩瞬间(每个精彩瞬间文件夹一条)和片段。标记作为时间线标记点导入,收藏、拒绝和关键词则成为片段颜色、旗标和关键词。

FCPXML,外加一个标记点 EDL 和一个元数据 CSV。

Premiere Pro

与你的文件夹对应的素材箱、带标记点的片段、每个精彩瞬间作为带入点和出点的命名片段,以及一个由精彩瞬间组成的序列。

FCP7 XML:文件 → 导入。

静帧净化

从视频中取照片,一步步讲清楚 →

暂停帧的时域降噪

Ctrl+p

视频暂停片刻后,用这一帧及其前后各 5 帧重建画面,每一帧都按它们之间的运动对齐到这一帧上:光线昏暗时传感器产生的噪点大多消失(时域降噪),细节保留。4K 大约需要一秒;必须开启防抖。它默认开启,所以只要暂停就行;Ctrl+p 关闭它,再按一次重新开启,对后续片段同样有效。

全尺寸暂停帧

Ctrl+f

以素材本身的分辨率显示暂停的帧,不受播放设置影响;开启 Ctrl+p 时在同一次处理中一并净化。在侧边面板中,Performance & Quality → Paused frame → Full size 会在每次暂停后自动这样做。

降噪与水下色彩

降噪

Ctrl+n

暗部和水下的彩色斑块大多消失,细节保留。适用于任何片段,Log 或非 Log,在 GPU 上运行。这一设置会沿用到后续片段。仅用于播放:导出的文件不降噪。

水下色边

Ctrl+a

水对蓝光的折射比对红光强,所以在相机平面玻璃后面,红色和蓝色越靠近画面边缘就分得越开。凡是镜头在水下的地方,每种颜色都会被移回它自己的光线落点,完全依据物理计算,不针对素材拟合;在水上则不做任何改变。Ctrl+a 保留录制时的色边,再按一次则重新去除。仅用于播放。

在 Osmo Action 6 的潜水片段上,画面边缘红色 3-7 px 的色边缩小到约一个像素以内。

侧边面板与菜单

侧边面板

Tab

各项设置都在窗口右侧、视频旁边的面板中,视频会为它让出位置;快捷键标在对应功能旁边。Tab 隐藏或显示面板。

  • Project,面板打开时所在的部分:这次旅行的项目文件夹(Initialize the project here)、片段预览、这个片段的标记和精彩瞬间、标记一段并把它保存为精彩瞬间;
  • Clip:片段的信息、访达文件资源管理器和路径、它的精彩时刻、导出片段或标记的一段、Export in SDR、上一个和下一个片段;
  • Look:视频输出、手动选择 Log 曲线、降噪;
  • Stabilization:Gyroflow、视角、强度、地平线、镜头及其色边;
  • Performance & Quality:防抖时的帧率和尺寸、暂停的帧、边缘填充、GPU 跟不上时是否询问;
  • Telemetry:是否显示、所在角落、单位、字段;
  • Dolby Vision(Mac App):trim 参数滑块;
  • Support:版本号、Keys…、Note for the agent…、Report this camera…、Set up again…,以及网站和 GitHub 的链接。

菜单

右键

有侧边面板时(App 和插件 zip 包),右键打开的是 mpv 自己的菜单。没有侧边面板时,右键打开插件菜单:快捷键能做的一切都在这里,旁边标着快捷键,还有没有快捷键的功能。需要 mpv 0.41 或更高版本。

Make these the defaults

在 Look、Stabilization、Quality 和 Telemetry 的底部(菜单中为 Remember as default):把当前设置保留到下次启动。

Report this camera…

面板 → Support

在 GitHub 上新建一个 issue,附上插件在片段中找到的信息。

快捷键

几乎每个操作也都在侧边面板中,旁边标着它的快捷键。

按键作用用于 input.conf 的名称
按两次 l标记一段:先是开头,再是结尾(mpv 的 A-B 循环)
k把标记的一段保存为精彩瞬间(先询问名称)
M在此处添加标记;在标记上:删除它
X把片段放到一边:不感兴趣
Ctrl+x把标记的一段从片段中剪掉(先询问);原始文件移到废纸篓
K收藏:正在播放的精彩瞬间,否则是当前片段;再按一次:取消
Shift+E按播放的样子导出片段或标记的一段(先询问名称);按两次:取消gyroflow/export
Ctrl+g防抖开启 → 更宽视角 → 关闭gyroflow/toggle
Ctrl+k防抖强度:弱 → 中 → 强gyroflow/level
Ctrl+b边缘填充方式:按方向留下的轨迹、画面边缘向外扩散、背景色gyroflow/edges
Ctrl+u镜头在水上,再切回gyroflow/lens
Ctrl+a去除水下色边,或保留录制原样gyroflow/fringes
Ctrl+e在 Gyroflow 中打开片段gyroflow/edit
Ctrl+p暂停帧的时域降噪(静帧净化),开(默认)或关gyroflow/still
Ctrl+f全尺寸显示暂停的帧gyroflow/full
Ctrl+s下一种视频输出:HDR、HLG+DV(Mac App)和各种 SDR 风格dlogm/sdr
Ctrl+h直接切换到 HDRdlogm/hdr
L关闭 Log 处理:按录制原样显示片段dlogm/off
Ctrl+l手动选择 Log 曲线dlogm/curve
Ctrl+n降噪开或关dlogm/denoise
Ctrl+t遥测数据关或开dji_telemetry/toggle
Ctrl+] / Ctrl+[下一个、上一个精彩时刻(落在它前面两秒左右)highlights/next, highlights/prev
Page Up / Page Down同样跳到精彩时刻,落在标记本身(mpv 的章节键)
Ctrl+r给 AI 智能体的笔记agent/report
右键没有侧边面板时为插件菜单(有面板时为 mpv 自己的菜单)footage_menu/menu
Tab侧边面板,隐藏或显示side_panel/toggle

换用其他按键:在 input.conf 中绑定这些名称,例如 Ctrl+d script-binding dlogm/sdr。

相机

日常配合 DJI Osmo Action 6 使用,并在 GoPro HERO12 Black 上试过。其他 DJI 相机、其他 GoPro 和 Insta360 已在代码中支持,但尚未用真实素材试过。

在 GitHub issue 中附上几秒直接从存储卡拷出的素材,是让一台相机变为“已验证”的最快方式。

平台与安装

Apple Silicon Mac

日常使用中

macOS 15 或更高版本。App 自带 mpv 和 ffmpeg:无需另装任何东西。它采用 ad hoc 签名,所以第一次打开时:系统设置 → 隐私与安全性 → 仍要打开。它的设置会把它设为 MP4 视频的播放器,添加快速操作,并下载 DJI 的 LUT。

Windows 10 或 11

Alpha

独立的 App,有 x86-64 版和 Windows 11 on ARM 版,所需的一切都已包含在内。x86-64 版已试用且可正常工作,但测试还不多;ARM 版只经过构建检查。它只为你自己安装,无需管理员权限;第一次运行时 SmartScreen 会发出警告:更多信息 → 仍要运行。

Linux

未试用

插件,装进你自己的 mpv:每个发布版本都会构建,但尚未试用。防抖需要带 VapourSynth 构建的 mpv。

在你自己的 mpv 中使用插件

适用于任何系统:Log 色彩、遥测数据、精彩时刻和菜单都是纯 Lua 加 GPU 着色器。防抖和导出需要带 VapourSynth 构建的 mpv,并提供适用于 Apple Silicon 上的 macOS、Linux x86-64 和 Windows 的构建。mpv.conf 和 input.conf 中无需添加任何内容。

高级用户选项

每个插件读取 App 的 mpv/script-opts/ 文件夹中的 <plugin>.conf,位于 ~/Library/Application Support/ActionFootagePlayer/(Windows:%LOCALAPPDATA%\ActionFootagePlayer\)。Remember as default 会替你写入这些文件。其中几项:

设置文件

dlogm.conf
hdr_screen=hdr 和 sdr_screen=dv:Log 片段在 HDR 屏幕和没有 HDR 的屏幕上的起始风格(hdr、dv、dvsdr、tonemap、nbcu 或 maker);denoise=yes:一开始就开启降噪;dv_live_l1=no(Mac App):使用 trim 参数的固定亮度信息,而不是每一帧的
gyroflow.conf
view、level、horizon_lock、underwater:没有项目的片段的起始设置;chromatic、edges:适用于每个片段;resolution、fps_limit、edge_fill_rate、ask_when_slow:用于较慢的电脑;still_radius、paused_full_size:静帧净化;gyroflow_app:要打开的 Gyroflow App(Windows、Linux)
dji_telemetry.conf
fields、units、position、font_size、visible
highlights.conf
before=2:跳转落在精彩时刻前几秒;chapters:进度条上的标记

你自己的默认预设

没有项目的片段使用 Gyroflow 的默认预设,然后是你放在 App 的 gyroflow/ 文件夹中的 default.gyroflow。

给 AI 智能体的笔记

Ctrl+r

用于和 AI 智能体一起改进播放器:在你所指的地方拖出一个矩形,写一行说明,笔记就会连同屏幕画面、这一帧和播放器当时的状态一起保存,供智能体读取。

全部选项,见 GitHub 上的 README

命令行

在终端中导出一个或多个片段:与 Shift+E 相同,位于插件的文件夹中。

gyroflow-export

~/.config/mpv/scripts/gyroflow/gyroflow-export DJI_0007_D.MP4 DJI_0008_D.MP4
~/.config/mpv/scripts/gyroflow/gyroflow-export --from 1:20 --to 1:45 DJI_0007_D.MP4
--prores
用 ProRes 422 HQ 代替 HEVC,用于剪辑
--sdr, --nbcu
Rec.709:D-Log M 经 DJI 的 LUT,或任何曲线经 NBCU 的转换
--level, --wide, --edges, --underwater
防抖设置,与快捷键和菜单的设置相同
--no-stabilize
只做色彩转换
--background
以后台优先级运行,导出时可以继续工作

mpv 自己的选项

插件的选项也可以在 mpv 的命令行中使用:--script-opts=dlogm-sdr_screen=nbcu。

导出,见 GitHub 上的 README