Logopyheic-structpip install
pyheic-struct

Samsung to Apple,
Seamlessly.

The professional open-source toolkit to bridge the gap between Samsung Motion Photos and Apple Live Photos. No quality loss, just magic.

Try Online ConverterDownload Win EXEView on GitHub

Lossless Extraction

Directly extract original video streams from Samsung HEIC files without any re-encoding or quality degradation.

Smart Metadata

Automatically injects Apple-specific identifiers and MakerNotes to ensure perfect pairing on iOS and macOS.

Batch Processing

Power through entire media libraries with multi-threaded CLI and GUI tools designed for large-scale management.

Ready for Developers

Install the core library directly via pip and integrate it into your own workflows.

pip install pyheic-struct

Frequently Asked Questions

What is pyheic-struct?

It is a specialized utility to bridge the gap between Samsung's "Motion Photo" and Apple's "Live Photo". It parses the internal structure of HEIC files to extract embedded video and sync it with Apple-compatible metadata.

Why do I need this tool?

Samsung stores Motion Photo video inside the HEIC file itself (usually in an `mpvd` box), while Apple expects a separate MOV file linked by a unique `ContentIdentifier`. This tool handles the extraction and ID generation automatically.

Will I lose image or video quality?

No quality loss. The tool extracts the original video stream bit-for-bit without re-encoding. The image is reconstructed to ensure all necessary metadata fields are correctly populated for iOS compatibility.

Is my privacy protected?

Yes. On this website, files are processed in server memory and deleted immediately after processing. For 100% privacy, we recommend downloading the Offline EXE Tool or running the source code locally.

What is the "Shifted Item ID" issue?

Samsung sometimes uses 16-bit shifted IDs in HEIC metadata, which can break standard parsers. Our tool detects these vendor-specific quirks and corrects them during the reconstruction process.

Does it support other brands like Google Pixel?

The architecture uses a pluggable "Handler" system. Support for Google Pixel and Xiaomi is currently planned and will be added in future updates.

© 2026 pyheic-struct. Open source under MIT License.