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
Freely change your Live Photo cover — pick 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 an existing dual-file Live Photo pair directlyJPEG+MP4 / JPEG+MOV / HEIC+MP4 / HEIC+MOV / HEIC+MP4 (H.265) outputs — available formats adapt to the selected protocol| Merge Protocol | 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 form) back into a dual-file Live Photo, or into an independent still image (JPG / HEIC) and video (MP4 / MOV).
HEIC+MOV / JPG+MOV / JPG+MP4EXIF / ICC / GPS / shooting parameters are retained> ⚠️ About iPhone / iPad: due to iOS restrictions, Live Photos cannot be imported directly into iOS devices. This tool only produces the Live Photo data — import them via third-party software such as i4Tools (爱思助手).
| Split Protocol | Devices | Status |
|---|---|---|
| Apple - Live Photo | iPhone / iPad | ✅ Supported |
| vivo - Live Photo | vivo (≤ x200) | ✅ Supported |
Repair the display anomalies that appear when Apple Live Photos are exported. After scanning, review diagnostic details for each photo and filter by file type or repair status.
jpegtran rotation + stripping the extraneous thumbnailFFmpeg re-encode to bake the rotation matrix into the pixel dataOrientation tags (if present)Automatically scan, categorize, and archive photos by device, date, and Live Photo type based on EXIF 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), split (back to image + video), cover / keyphoto (change cover frame), repair (fix Apple Live Photo display issues), protocols (query protocol × format compatibility matrix), backend (choose the global rebuilt / legacy branch), update / update-check (check & install updates)livephotobox / livephoto / livebox / lpbContentIdentifier UUID, or vivo camera ID; rename outputs with templates like -n custom:{name}_{date} ({frame} token for the cover command); --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 · 简体中文
| Layer | Technology | Version |
|---|---|---|
| Language | C# | 13.0 |
| Native backend | Visual C++ / C++20 DLL (stable C ABI) | MSVC x64 (v143/v145) |
| Runtime | .NET | 9.0 |
| UI Framework | Windows App SDK (WinUI 3) | 1.8 |
| Architecture | MVVM (CommunityToolkit.Mvvm) | 8.4.2 |
| Image Processing | Magick.NET (ImageMagick) + Win2D | 14.16.0 / 1.3.2 |
| Image Scaling | PhotoSauce.MagicScaler | 0.15.0 |
| Metadata Engine | ExifTool (daemon mode) | 13.59 |
| Video Processing | FFmpeg (NVENC / QSV / AMF hardware acceleration) | n9.0.1 |
| JPEG Operations | jpegtran (lossless rotation, thumbnail stripping) | — |
| HEIC Codec | libheif (heif-enc / heif-dec) | 1.23.1 |
| HEIC Native Decode | PhotoSauce.NativeCodecs.Libheif (MagicScaler pipeline) | 1.19.5-preview1 |
| Markdown Rendering | Markdig | 1.3.2 |
| UI Extensions | CommunityToolkit.WinUI + FluentIcons | — |
| Command Line | System.CommandLine | 2.0.11 |
| Packaging | MSIX self-contained (no runtime required) | — |
> ExifTool / FFmpeg / jpegtran / libheif are bundled external tools (in the Tools/ folder) that handle metadata read/write and audio-video processing.
>
> Native support is kept outside the product-wide rebuilt / legacy switch in this phase. The default rebuilt branch does not implement or call any vendor protocol; legacy preserves the v2.2.1 compatibility path. Native protocol work is deferred until the neutral-media pipeline and independent verification are complete.
# 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.
live-photo-box/
├── LivePhotoBox.Core/ # Shared core library (protocols, merge/split/repair services, localization)
├── LivePhotoBox.Native/ # C++20 Native backend (stable C ABI; x64 DLL)
├── LivePhotoBox/ # Main project (WinUI 3 MSIX app)
│ ├── Assets/ # Icons, screenshots, static resources
│ ├── Controls/ # Custom controls (fullscreen lightbox, status bar)
│ ├── Converters/ # XAML value converters
│ ├── Helpers/ # Utilities (scrolling, formatting, hover preview, etc.)
│ ├── Models/ # Data models
│ ├── Services/ # GUI business logic (delegates to LivePhotoBox.Core)
│ ├── Strings/ # Multilingual resources (zh-Hans / en-US)
│ ├── ViewModels/ # MVVM ViewModel layer
│ └── Views/ # XAML pages
├── LivePhotoBox.CLI/ # Command-line interface (livephotobox)
├── tests/ # Test projects (Core / CLI / UI / benchmarks)
├── docs/ # Project documentation
├── changelogs/ # Release notes
├── scripts/ # Build & packaging scripts
│ └── native/ # MSVC/Native build and smoke-test script
├── artifacts/ # Native build outputs (gitignored)
├── screenshots/ # Screenshots
├── lpb.cmd # Dev alias for the source CLI (runs current code, same as `dotnet run`)
└── README.md
📖 See Project Overview for the complete directory reference.
| 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 |
|---|---|---|
| FFmpeg | Video transcoding and stream remuxing | LGPL/GPL |
| ExifTool by Phil Harvey | Global metadata parsing, injection, XMP reconstruction | Perl |
| libheif | HEIC/HEIF encoding & decoding pipeline | LGPL-3.0 |
| jpegtran | Lossless JPEG transforms (DCT coefficient space) | Free software |
| Magick.NET by dlemstra | HEIC/HEIF decoding via libheif | Apache 2.0 |
| CommunityToolkit.Mvvm | MVVM framework | MIT |
| PhotoSauce.MagicScaler | High-performance image scaling | MIT |
| Markdig | Markdown rendering | BSD-2-Clause |
| FluentIcons | Fluent icon set | MIT |
📊 Repository Traffic
Views: 2,257 ｜ Uniques: 176 (14-day) ｜ Clones: 1,593 ｜ Cloners: 137 (14-day)
Top referrers (14-day): github.com · Bing · chatgpt.com · Google · t.co · doubao.com
Top content (14-day): releases · releases/tag/v2.2.1 · releases/tag/v2.2.0 · README.zh-CN.md
> Data since 2026-08-02 · Last updated: 2026-09-02 (UTC+8)
Made with ❤️ by LengxiQwQ
