A command-line tool for handling Samsung Motion Photos. Extract video and image components from motion photo files (.jpg, .jpeg, .heic).

• Process Samsung Motion Photos (both legacy and current formats)
• Regular expression support for file matching
• Configurable output options
• Supports JPG and HEIC motion photo formats
• Configurable logging system

• --input <path>: Path to motion photo file or directory
  • Single file: photo.jpg
  • Directory: ./photos
  • Regex pattern: /IMG_\d{4}\.jpg/
  • Glob pattern: *.jpg
  • Supported formats: .jpg, .jpeg, .heic

• --output <dir>: Output directory for extracted files (default: current directory)
• --delete-orig: Remove original file after successful extraction
• --rename-orig: Use base name for extracted files, add _original to source file
• --extract-photo: Extract photo component (default: true)
• --force: Overwrite existing output files

• --log-file <path>: Log file path
• --log-level <level>: Log level (debug, info, warn, error)
• --no-console-log: Disable console output

Configuration can be provided through:

• Command line arguments
• Configuration file (go-motion-photo.yaml)
• Environment variables

Default config locations:

• Current directory
• $HOME/.config/go-motion-photo

Using command-line flags:

# Process single file go-motion-photo photo.jpg # Specify output location go-motion-photo --input photo.jpg --output ./extracted # Process all supported files in directory go-motion-photo --input ./photos # Process files matching regex pattern go-motion-photo --input /IMG_\d{4}\.jpg/ # Keep original naming scheme go-motion-photo --input photo.jpg --rename-orig # Process HEIC file and overwrite existing outputs go-motion-photo --input photo.heic --force

Using configuration file (go-motion-photo.yaml):

input: "./photos" output: "./extracted" delete_orig: false rename_orig: true log: file: "motion-photo.log" level: "info" no_console: false

Binary releases are available for Linux, macOS, and Windows on the releases page.

Note: This tool is specifically designed for Samsung Motion Photos and may not work with motion photo formats from other manufacturers.