QuickLook Live Photo 插件

这是一个面向 Windows QuickLook 4.0 的 Live Photo 预览插件。它可以识别部分 Android Motion Photo JPEG，在资源管理器中按空格键预览照片并播放内嵌视频。

下载插件 · 反馈问题

界面展示

功能

• 支持 Google Motion Photo XMP 和旧版 MicroVideoOffset 标记。
• 支持带 LIVE_<长度> 尾部标记的实况 JPEG，并校验内嵌 MP4 结构。
• 提供播放/暂停、重播、静音切换和循环播放控制，默认静音。
• 普通 JPEG 会交回 QuickLook 原有图片插件处理。
• 原始照片只读；视频提取使用隔离的临时文件，并在关闭预览后清理。

暂不支持 iPhone HEIC/JPEG + MOV 配对、HEIC/AVIF 容器及厂商私有压缩格式。具体视频编码能力取决于 QuickLook 4.0 搭载的 LAVFilters。

快速安装

1. 安装并运行 QuickLook 4.0。
2. 打开本项目的 Releases 页面，在所需版本的 Assets 中下载 QuickLook.Plugin.LivePhoto.qlplugin，不要下载 Source code。
3. 在资源管理器中选中下载的 .qlplugin 文件，按空格键。
4. 点击安装插件并重启 QuickLook。
5. 选中实况 JPEG，按空格键即可预览。

首个发布版本为 v0.1.0-beta.1，属于测试版。不同手机导出的动态照片格式可能不同，请先用自己的照片确认兼容性。仓库的 dist/ 中也附带安装包，日常下载请以 Releases 页面为准。

从源码构建与测试

要求 Windows PowerShell 5.1 和 .NET Framework 4.x。构建脚本会引用本机 QuickLook 安装目录中的程序集，不需要 Python 或 .NET SDK。以下命令在仓库根目录运行，请将 QuickLookDir 替换为自己的 QuickLook 安装路径。

.\build.ps1 -QuickLookDir 'D:\AppsForCommon\QuickLook'
.\test.ps1 -QuickLookDir 'D:\AppsForCommon\QuickLook' -Samples '.\test.jpg'
.\smoke-test.ps1 -QuickLookDir 'D:\AppsForCommon\QuickLook' -Sample '.\test.jpg'

构建输出位于根目录下的 build/，安装包位于 dist/。播放测试依赖已构建的插件，请先运行构建或自动化测试。build/、bin/、obj/ 等构建产物不应提交到 Git。

目录结构

LivePhotoQuickLook/
├─ src/                 插件源码
├─ tests/               格式边界测试和播放烟雾测试
├─ dist/                可直接安装的插件包
├─ build.ps1            构建脚本
├─ test.ps1             自动化测试脚本
├─ smoke-test.ps1       真实 WPF/LAV 播放测试
├─ test.jpg             动态照片测试样本
├─ test1.jpg            README 界面展示截图
├─ QuickLook.Plugin.LivePhoto.csproj    C# 项目配置
├─ QuickLook.Plugin.Metadata.config    插件元数据
├─ README.md            安装与开发说明
└─ LICENSE              GPL-3.0-or-later 许可证

test.jpg 是仓库附带的二进制示例文件，用于验证实况 JPEG 识别和播放流程。

问题反馈

如果照片不能识别或视频不能播放，请在 Issues 中提供 Windows 和 QuickLook 版本、插件版本、手机型号以及具体表现。提供照片样本前，请先确认其中没有需要保密的画面、位置或其他个人信息。

许可证

本项目采用 GNU GPL v3.0 或更高版本 发布。