wangjs-jacky Android Live Photo
Create an Android/Google Motion Photo from a supplied MP4. The output is one untouched .jpg binary containing a JPEG cover, standard XMP metadata, and the original MP4 bytes.
Workflow
- Use the exact video attachment path supplied by the user. Do not scan attachment folders.
- Run
ffprobeon the MP4. Stop and report the issue if it has no readable video stream or duration. - Run the bundled script, defaulting the cover to the midpoint:
node scripts/convert_motion_photo.mjs \
--input /absolute/input.mp4 \
--output /absolute/output_MP.jpg
Use --cover-at <seconds> only when the user specifies a preferred cover moment.
- Trust completion only after the script reports
validation: passed. It verifies JPEG SOI, Motion Photo XMP, declared embedded-video length, MP4 signature, and byte-for-byte equality of the embedded MP4 with the source. - State the output path and compatibility boundary: the result has worked with social platforms that recognize standard Android Motion Photos; Honor Gallery may not register imported generic Motion Photos as native Live Photos.
Delivery
Do not send the dynamic JPEG through an image renderer or editor: recompression strips the embedded MP4 and turns it into a static image. Preserve the exact generated binary. If the environment supports general file attachment, send it unchanged; otherwise provide the absolute output path or package it in an untouched archive using the available file-delivery mechanism.
Requirements
Require Node.js 20+, ffmpeg, and ffprobe on PATH. The script supports MP4 input only and does not alter source media.