winget install --id=LengxiQwQ.LivePhotoBox -e livephotobox is a command-line utility for merging image and video files into live photos compatible with HUAWEI, Samsung, Google, Apple, Xiaomi, and vivo gallery applications. A live photo is a single file containing both a still image and a short video — when viewed in a supported gallery, the video plays automatically.
Live Photo Box（实况照片工具箱）
Unifying all live photo protocols for seamless cross-device viewing & migration
📖 README Language: English · 简体中文
Or install the CLI via winget: winget install LengxiQwQ.LivePhotoBox
> 🎨 Live Photo Box could use a new icon > > Now that Live Photo Box's main features are gradually stabilizing, the author would like to give the app a more fitting icon and refresh the homepage banner as well. > > If you have a design direction you like or would like to try creating something, feel free to share it in GitHub Discussions →. PNG, PSD, SVG, Figma files, and links to other design websites are all welcome. Simple sketches and ideas are welcome too. Thank you!
Although Live Photos from different brands all combine a still image with a short video, they use different file structures and data formats. When moving across devices or platforms, this can lead to playback issues, incorrect orientation, lost motion, or missing metadata.
Live Photo Box provides a unified way to merge, split, convert, repair, and edit Live Photos, making it easy to move them between different brands and devices.
It also preserves as much of the original detail and information as possible, including HDR, EXIF data, camera settings, capture information, and original media content — keeping every conversion as close as possible to the original photo.
🖼️ Live Photo Edit
🔗 Merge Live Photo
Change the key photo / cover frame of a Live Photo, picking the perfect moment from the video timeline.
Convert a dual-file Live Photo (or any image + video pair) into a single-file Live Photo, viewable on Windows and Android devices.
JPG / HEIC) + a video (MP4 / MOV), or scan a whole folder and auto-pair everything into a batch queueContentIdentifier UUID, or vivo camera ID; or merge ready-made dual-file pairs directlyJPEG+MP4 / JPEG+MOV / HEIC+MP4 / HEIC+MOV / HEIC+MP4(H.265) output formats (automatically filters supported options)| Merge Protocol | Target Devices | Status |
|---|---|---|
| Google - Micro Video (v1) | Windows / Xiaomi (legacy MIUI) / Pixel | ✅ Supported |
| Google - Motion Photo (v2) | Windows / Xiaomi / Pixel | ✅ Supported |
| OPPO - O-Live Photo | Windows / Xiaomi / OPPO | ✅ Supported |
| HUAWEI - Moving Photo | Huawei / Honor | ✅ Supported |
| Samsung - Motion Photo | Windows / Samsung | ✅ Supported |
| vivo - Live Photo | Windows / vivo (≥ x300) | 🟡 In Testing |
Split a Live Photo (single-file format) into a dual-file Live Photo, or into an independent still image (JPG / HEIC) and video (MP4 / MOV).
HEIC+MOV / JPG+MOV / JPG+MP4 formatsEXIF / ICC / GPS / capture settings> ⚠️ About iPhone / iPad: Due to iOS system limitations, Live Photos cannot be imported directly into iOS devices. This software generates standard Live Photo data; import requires third-party tools like i4Tools.
| Split Protocol | Target Devices | Status |
|---|---|---|
| Apple - Live Photo | iPhone / iPad | ✅ Supported |
| vivo - Live Photo | vivo (≤ x200) | ✅ Supported |
Repair display anomalies from exported Apple Live Photos. View diagnostic details for each photo after scanning, and filter by file type or repair status.
Orientation tags if presentAutomatically scan, categorize, and archive photos by device, date, and Live Photo type based on metadata. Starting with iPhone photos, expanding to more brands.
Live Photo Box ships a command-line interface — livephotobox — that shares 100% of its core logic with the GUI, ideal for scripting and AI agents.
merge (single-pair or batch merge), split (split into photo + video), repair (repair Apple live photo display issues), cover (inspect/modify cover timestamp), protocols (protocol & format compatibility query), update / update-check (check & install updates)livephotobox / livephoto / livebox / lpbContentIdentifier UUID, or vivo camera ID; rename outputs with templates like -n custom:{name}_{date}; --after moves sources to a folder / recycle bin on completion--json outputs structured results that scripts and AI agents can consume directly; --dry-run previews operations without touching files{folder}_ subfolder — never the terminal’s current directory. -w overwrites existing outputs instead of auto-renaming-x64-cli.zip (no install needed; ships add-to-path.cmd / remove-from-path.cmd helpers to add/remove PATH in one click); install the CLI-only edition via winget install LengxiQwQ.LivePhotoBox📖 CLI User Guide: English · 简体中文
| Technology | Version | Role |
|---|---|---|
| C# | 13.0 | GUI, CLI, application workflows and orchestration |
| C++ | C++20 | Low-level media containers, metadata and Live/Motion Photo protocols |
| .NET | 9.0 | Application runtime |
| WinUI 3 / Windows App SDK | 1.8 | Windows desktop UI |
| CommunityToolkit.Mvvm | 8.4.2 | MVVM and state management |
| LivePhotoBox.Native | Stable C ABI | Bridge between C# and the Native C++ core |
| WIC | Windows | Image decoding, encoding and conversion |
| Windows Media Foundation | Windows | Video probing, remuxing and transcoding |
| PhotoSauce.MagicScaler | 0.15.0 | Image scaling and processing |
| System.CommandLine | 2.0.11 | CLI framework |
| MSIX / Self-contained | — | GUI and CLI distribution |
| > Note: Some currently published releases still use the previous external-tool-based media pipeline. The development branch is moving these responsibilities into LivePhotoBox.Native, and the new Native architecture will replace that implementation in a future release. |
# Clone the repository
git clone https://github.com/lengxiqwq/live-photo-box.git
cd live-photo-box
The repo ships ready-made PowerShell build scripts (scripts/) for both GUI and CLI — no need to run dotnet commands by hand:
| Script | Produces |
|---|---|
scripts/build-dev.ps1 | Unpackaged dev build (GUI + CLI) into publish/ |
scripts/build-cli-release.ps1 | Standalone single-file CLI zip (publish/Live-Photo-Box-v{version}-x64-cli.zip) |
scripts/build-release.ps1 | Full release trio: portable zip + CLI zip + installer |
> Scripts accept -CI for GitHub Actions and other CI environments (no pause prompt).
For local verification, run the Native smoke test and the solution/CLI test suites from the repository root:
powershell -NoProfile -ExecutionPolicy Bypass -File scripts/native/build-native.ps1 -Configuration Release -Architecture x64 -RunTests
dotnet test
python scripts/testing/run-cli-integration-test.py
All three commands must pass before creating a release tag. scripts/build-release.ps1 also invokes the Native build and checks that LivePhotoBox.Native.dll is present in GUI and CLI outputs.
| Language | Status |
|---|---|
| 中文（简体）(zh-Hans) | ✅ Complete |
| English (en) | ✅ Complete |
Follows system language automatically; can also be switched manually in Settings.
Issues and Pull Requests are welcome!
This project is open-source under the GNU General Public License v3.0 (GPL 3.0). See the LICENSE file for details.
| Tool / Library | Purpose | License |
|---|---|---|
| CommunityToolkit.Mvvm | MVVM framework | MIT |
| PhotoSauce.MagicScaler | High-performance image scaling | MIT |
| Markdig | Markdown rendering | BSD-2-Clause |
| FFmpeg | Previous-generation runtime & independent verification reference | LGPL/GPL |
📊 Repository Traffic
Views: 4,117 ｜ Uniques: 197 (14-day) ｜ Clones: 4,959 ｜ Cloners: 157 (14-day)
Top referrers (14-day): Google · github.com · Bing · chatgpt.com · yandex.ru · Baidu
Top content (14-day): releases/tag/v2.2.1 · releases · README.zh-CN.md · docs/CLI-User-Guide.zh-CN.md
> Data since 2026-08-02 · Last updated: 2026-10-03 (UTC+8)
Made with ❤️ by LengxiQwQ
