live-photo-box

项目概述

Live Photo Box（实况照片工具箱）是一款面向 Windows 的桌面端实况照片处理工具。不同品牌的实况照片虽然都包含一张静态图片和一段短视频，但文件结构和数据格式各不相同。在跨设备、跨平台传输时，常出现无法播放、方向错误、动态效果丢失或元数据缺失等问题。Live Photo Box 提供了一套统一的方法来合并、拆分、转换、修复和编辑实况照片。

主要功能

• 编辑实况照片：自由更改实况照片的封面，从视频时间轴中选取最佳瞬间；支持导出单帧、全部帧，或导出为视频/GIF；支持快速转换实况照片协议
• 合并实况照片：将双文件实况照片（或任意图像+视频对）转换为单文件实况照片；支持拖拽或选择图像（JPG/HEIC）和视频（MP4/MOV），也可扫描整个文件夹自动配对并加入批处理队列；支持多种目标协议，包括 JPEG+MP4、JPEG+MOV、HEIC+MP4、HEIC+MOV、HEIC+MP4 (H.265) 等；支持文件名模板批量重命名
• 拆分实况照片：将单文件实况照片拆分为双文件实况照片，或拆分为独立的静态图像（JPG/HEIC）和视频（MP4/MOV）；支持按协议（Google/OPPO/vivo/Samsung/HUAWEI）过滤批量拆分；可去除实况照片元数据，同时保留 EXIF、ICC、GPS 等所有其他元数据
• 修复实况照片：修复 Apple 实况照片在 Windows 上导出时出现的显示异常，包括缩略图过多与横向拉伸、前置摄像头视频旋转、HEIC 方向标签错误等问题
• 命令行界面（CLI）：提供 livephotobox CLI 工具，支持合并、拆分、更换封面、修复、查询协议兼容性等命令，适合脚本和 AI 代理使用

适用人群

• 需要在不同品牌设备（iPhone、华为、OPPO、vivo、三星、小米等）之间迁移实况照片的用户
• 希望将双文件实况照片转换为单文件格式以便在 Windows 和 Android 上查看的用户
• 需要批量处理大量实况照片的摄影爱好者和内容创作者

快速上手

1. 通过 winget 安装 CLI：winget install LengxiQwQ.LivePhotoBox
2. 下载 GUI 版本：从 GitHub Releases 下载安装包或便携版
3. 启动应用，选择“合并”、“拆分”或“修复”功能
4. 拖拽文件或扫描文件夹，批量处理实况照片
5. 命令行使用：livephotobox merge --image image.jpg --video video.mp4 等

核心优势

• 统一实况照片协议：支持 Google、OPPO、华为、三星、vivo 等主流品牌的实况照片协议
• 保留原始细节：尽可能保留 HDR、EXIF、相机设置、拍摄信息等原始数据
• 批量处理：支持并行批量合并与拆分，带有进度显示和状态筛选
• GUI + CLI 双模式：提供图形界面和命令行界面，适合不同使用场景
• 开源免费：基于 GPL-3.0 许可证开源

系统要求

• 操作系统：Windows（桌面版）
• 额外依赖：内置 ExifTool、FFmpeg、jpegtran、libheif 等工具

注意事项

• 由于 iOS 系统限制，实况照片无法直接导入 iOS 设备，需通过第三方软件（如爱思助手）导入
• 项目仍处于积极开发中，部分功能（如照片整理）仍在开发中