PicView Motion Photo (Live Photo) Support

.github/workflows/BuildMacOS.yml

@@ -28,6 +28,44 @@ jobs:
         id: get-version
         run: pwsh -File "${{ github.workspace }}/Build/Get-VersionInfo.ps1"
 
+      # Step 3.1: Restore or build picview-ffmpeg, the statically-linked FFmpeg used
+      # for motion photo playback. Outputs are cached; a full build takes roughly ten
+      # minutes, cache hits are instant.
+      - name: Cache picview-ffmpeg (osx-arm64)
+        id: cache-ffmpeg-osx-arm64
+        uses: actions/cache@v4
+        with:
+          path: Build/ffmpeg-native/osx-arm64
+          key: picview-ffmpeg-osx-arm64-${{ hashFiles('Build/Build-FFmpegNative.ps1', 'Build/ffmpeg/**', 'Native/ffmpeg/**') }}
+
+      - name: Cache picview-ffmpeg (osx-x64)
+        id: cache-ffmpeg-osx-x64
+        uses: actions/cache@v4
+        with:
+          path: Build/ffmpeg-native/osx-x64
+          key: picview-ffmpeg-osx-x64-${{ hashFiles('Build/Build-FFmpegNative.ps1', 'Build/ffmpeg/**', 'Native/ffmpeg/**') }}
+
+      - name: Setup zig
+        if: steps.cache-ffmpeg-osx-arm64.outputs.cache-hit != 'true' || steps.cache-ffmpeg-osx-x64.outputs.cache-hit != 'true'
+        uses: goto-bus-stop/setup-zig@v2
+        with:
+          version: 0.15.1
+
+      - name: Build picview-ffmpeg (macOS)
+        if: steps.cache-ffmpeg-osx-arm64.outputs.cache-hit != 'true' || steps.cache-ffmpeg-osx-x64.outputs.cache-hit != 'true'
+        shell: pwsh
+        run: |
+          brew install nasm make
+
+          # FFmpeg needs GNU make; brew installs it keg-only as gmake, so expose
+          # the directory containing it as 'make' to the build script
+          $env:PV_EXTRA_PATH = Join-Path (brew --prefix make) 'libexec/gnubin'
+
+          $targets = @()
+          if ('${{ steps.cache-ffmpeg-osx-arm64.outputs.cache-hit }}' -ne 'true') { $targets += 'osx-arm64' }
+          if ('${{ steps.cache-ffmpeg-osx-x64.outputs.cache-hit }}' -ne 'true') { $targets += 'osx-x64' }
+          & "${{ github.workspace }}/Build/Build-FFmpegNative.ps1" -Targets $targets
+
       # Step 4: Restore dependencies
       - name: Restore dependencies
         run: dotnet restore src/PicView.Avalonia.MacOS/PicView.Avalonia.MacOS.csproj

.github/workflows/BuildWin32.yml

@@ -28,6 +28,41 @@ jobs:
       - name: Get version from Directory.Build.props
         id: get-version
         run: pwsh -File "${{ github.workspace }}/Build/Get-VersionInfo.ps1"
+
+      # Step 3.1: Restore or build picview-ffmpeg, the statically-linked FFmpeg used
+      # for motion photo playback. Outputs are cached; a full build takes roughly ten
+      # minutes, cache hits are instant.
+      - name: Cache picview-ffmpeg (win-x64)
+        id: cache-ffmpeg-win-x64
+        uses: actions/cache@v4
+        with:
+          path: Build/ffmpeg-native/win-x64
+          key: picview-ffmpeg-win-x64-${{ hashFiles('Build/Build-FFmpegNative.ps1', 'Build/ffmpeg/**', 'Native/ffmpeg/**') }}
+
+      - name: Cache picview-ffmpeg (win-arm64)
+        id: cache-ffmpeg-win-arm64
+        uses: actions/cache@v4
+        with:
+          path: Build/ffmpeg-native/win-arm64
+          key: picview-ffmpeg-win-arm64-${{ hashFiles('Build/Build-FFmpegNative.ps1', 'Build/ffmpeg/**', 'Native/ffmpeg/**') }}
+
+      - name: Setup zig
+        if: steps.cache-ffmpeg-win-x64.outputs.cache-hit != 'true' || steps.cache-ffmpeg-win-arm64.outputs.cache-hit != 'true'
+        uses: goto-bus-stop/setup-zig@v2
+        with:
+          version: 0.15.1
+
+      - name: Build picview-ffmpeg (Windows)
+        if: steps.cache-ffmpeg-win-x64.outputs.cache-hit != 'true' || steps.cache-ffmpeg-win-arm64.outputs.cache-hit != 'true'
+        shell: pwsh
+        run: |
+          # FFmpeg build toolchain inside the preinstalled MSYS2
+          & C:\msys64\usr\bin\pacman.exe -Sy --noconfirm --needed base-devel mingw-w64-x86_64-gcc mingw-w64-x86_64-nasm diffutils tar
+
+          $targets = @()
+          if ('${{ steps.cache-ffmpeg-win-x64.outputs.cache-hit }}' -ne 'true') { $targets += 'win-x64' }
+          if ('${{ steps.cache-ffmpeg-win-arm64.outputs.cache-hit }}' -ne 'true') { $targets += 'win-arm64' }
+          & "${{ github.workspace }}\Build\Build-FFmpegNative.ps1" -Targets $targets
 
       # Step 4 (x64): Publish x64 version
       - name: Publish x64 version

.gitignore

@@ -365,3 +365,6 @@ MigrationBackup/
 /src/.7z 
 /src/.zip 
 /src/.zip 
+
+# Cross-compiled picview-ffmpeg native libraries (produced by Build\Build-FFmpegNative.ps1)
+Build/ffmpeg-native/

Build/Build Avalonia.Win32 arm64.ps1

@@ -56,11 +56,8 @@ New-Item -Path $outputPath -ItemType Directory | Out-Null
 # Copy the build output to the final destination
 Copy-Item -Path "$tempPath\*" -Destination $outputPath -Recurse -Force
 
-# Remove the PDB file
-$pdbPath = Join-Path -Path $outputPath -ChildPath "PicView.Avalonia.pdb"
-if (Test-Path $pdbPath) {
-    Remove-Item -Path $pdbPath -Force
-}
+# Remove debug symbols (native PicView.pdb alone is >150 MB)
+Remove-Item -Path "$outputPath\*.pdb" -Force -ErrorAction SilentlyContinue
 
 #Remove uninstended space
 Rename-Item -path $outputPath -NewName $outputPath.Replace(" ","")

Build/Build Avalonia.Win32 x64.ps1

@@ -34,11 +34,8 @@ if (Test-Path $licensePath) {
     Remove-Item -Path $licensePath -Force
 }
 
-# Remove the PDB file
-$pdbPath = Join-Path -Path $outputPath -ChildPath "PicView.Avalonia.pdb"
-if (Test-Path $pdbPath) {
-    Remove-Item -Path $pdbPath -Force
-}
+# Remove debug symbols (native PicView.pdb alone is >150 MB)
+Remove-Item -Path "$outputPath\*.pdb" -Force -ErrorAction SilentlyContinue
 
 #Remove uninstended space
 Rename-Item -path $outputPath -NewName $outputPath.Replace(" ","")

Build/Build Avalonia.Win32.ps1

@@ -37,11 +37,7 @@ $avaloniaProjectPath = Join-Path -Path $PSScriptRoot -ChildPath "..\src\PicView.
 # Run dotnet publish for the Avalonia project
 dotnet publish $avaloniaProjectPath --runtime "win-$Platform" --self-contained true --configuration Release --output $outputPath /p:PublishReadyToRun=true
 
-
-# Remove the PDB file
-$pdbPath = Join-Path -Path $outputPath -ChildPath "PicView.Avalonia.pdb"
-if (Test-Path $pdbPath) {
-    Remove-Item -Path $pdbPath -Force
-}
+# Remove debug symbols (native PicView.pdb alone is >150 MB)
+Remove-Item -Path "$outputPath\*.pdb" -Force -ErrorAction SilentlyContinue
 
 

Build/Build-FFmpegNative.ps1

@@ -0,0 +1,154 @@
+<#
+.SYNOPSIS
+Builds picview-ffmpeg, the statically-linked, purpose-built FFmpeg used for motion
+photo video playback, for all supported targets:
+
+  win-x64, win-arm64, linux-x64, linux-arm64, osx-x64, osx-arm64
+
+Output lands in Build\ffmpeg-native\<target>\ and is picked up by the platform
+projects at build/publish time (motion photos degrade to still images when absent).
+
+.DESCRIPTION
+The FFmpeg build is trimmed to exactly what motion photo playback needs:
+mov/mp4 demuxer + h264/hevc decoders + libswscale. No audio, no network, no
+devices, no filters, no programs. The result is statically linked into a single
+native library per target that exports only four functions (pv_open,
+pv_decode_next, pv_close, pv_version) - see Native\ffmpeg\picview_ffmpeg.c.
+
+Prerequisites (one-time):
+  Windows host (builds every target by cross-compiling):
+    * MSYS2 (https://www.msys2.org), installed to C:\msys64 by default:
+        pacman -Syu
+        pacman -S base-devel mingw-w64-x86_64-gcc mingw-w64-x86_64-nasm diffutils tar
+    * zig on PATH (https://ziglang.org - used to cross-compile Linux/macOS/ARM):
+        winget install Zig.Zig    (or scoop install zig)
+  macOS host (builds the osx-* targets):
+    * brew install nasm zig make
+    * GNU make must be reachable as 'make'; set PV_EXTRA_PATH to the directory
+      that contains it, e.g. "$((brew --prefix make))/libexec/gnubin"
+
+.PARAMETER Targets
+Comma-separated list of targets to build. Defaults to all six.
+
+.PARAMETER Msys2Root
+MSYS2 installation root. Defaults to C:\msys64.
+
+.EXAMPLE
+.\Build-FFmpegNative.ps1 -Targets win-x64
+#>
+param (
+    [Parameter()]
+    [string[]]$Targets = @("win-x64", "win-arm64", "linux-x64", "linux-arm64", "osx-x64", "osx-arm64"),
+
+    [Parameter()]
+    [string]$Msys2Root = "C:\msys64"
+)
+
+$ErrorActionPreference = "Stop"
+
+$ffmpegVersion = "9.0.1"
+$scriptRoot = $PSScriptRoot
+$repoRoot = Join-Path $scriptRoot ".."
+$shim = Join-Path $repoRoot "Native\ffmpeg\picview_ffmpeg.c"
+$outputDir = Join-Path $scriptRoot "ffmpeg-native"
+
+if (-not (Get-Command zig -ErrorAction SilentlyContinue)) {
+    Write-Error "zig not found on PATH. Install it with: winget install Zig.Zig (or scoop install zig / brew install zig)"
+}
+
+if ($IsWindows) {
+    $bash = Join-Path $Msys2Root "usr\bin\bash.exe"
+    if (-not (Test-Path $bash)) {
+        Write-Error "MSYS2 not found at $Msys2Root. Install MSYS2 and run: pacman -S base-devel mingw-w64-x86_64-gcc mingw-w64-x86_64-nasm diffutils tar"
+    }
+}
+else {
+    $bash = (Get-Command bash -ErrorAction SilentlyContinue).Source
+    if (-not $bash) {
+        Write-Error "bash not found on PATH"
+    }
+}
+
+# Scratch space lives outside the repo; the ffmpeg source is cached there.
+$workRoot = Join-Path ([System.IO.Path]::GetTempPath()) "picview-ffmpeg-build"
+New-Item -ItemType Directory -Force -Path $workRoot | Out-Null
+$sourceDir = Join-Path $workRoot "ffmpeg-$ffmpegVersion"
+
+function ConvertTo-ShellPath([string]$path) {
+    # MSYS2 bash wants /c/... paths; native shells want the path as-is.
+    # GetFullPath (unlike Resolve-Path) also works for paths that do not exist
+    # yet, e.g. the output directory on a fresh checkout.
+    $full = [System.IO.Path]::GetFullPath($path)
+    if (-not $IsWindows) {
+        return $full
+    }
+
+    $drive = $full.Substring(0, 1).ToLowerInvariant()
+    return "/$drive/" + ($full.Substring(3) -replace '\\', '/')
+}
+
+# 1. Fetch the FFmpeg source once
+if (-not (Test-Path $sourceDir)) {
+    $tarball = Join-Path $workRoot "ffmpeg-$ffmpegVersion.tar.xz"
+    if (-not (Test-Path $tarball)) {
+        Write-Host "Downloading FFmpeg $ffmpegVersion source..."
+        Invoke-WebRequest -Uri "https://ffmpeg.org/releases/ffmpeg-$ffmpegVersion.tar.xz" -OutFile $tarball
+    }
+    Write-Host "Extracting FFmpeg source..."
+    if ($IsWindows) {
+        & $bash -lc "tar -xf `"`$(cygpath -u '$tarball')`" -C `"`$(cygpath -u '$workRoot')`""
+        if ($LASTEXITCODE -ne 0) { throw "Failed to extract FFmpeg source" }
+    }
+    else {
+        tar -xf $tarball -C $workRoot
+        if ($LASTEXITCODE -ne 0) { throw "Failed to extract FFmpeg source" }
+    }
+}
+
+# 2. Build the small Mach-O nm used by configure to detect the '_' symbol prefix
+#    when cross-compiling for Apple targets from Windows (GNU nm cannot read
+#    Mach-O objects). Apple hosts use their native nm instead.
+if ($IsWindows) {
+    $machonm = Join-Path $workRoot "machonm.exe"
+    Write-Host "Building machonm helper..."
+    zig cc -target x86_64-windows (Join-Path $scriptRoot "ffmpeg\machonm.c") -o $machonm
+    if ($LASTEXITCODE -ne 0) { throw "Failed to build machonm" }
+}
+else {
+    $machonm = "nm"
+}
+
+# 3. Build each target
+# build-target.sh prepends PV_EXTRA_PATH to its PATH; make sure zig (and any
+# caller-provided toolchain directory, e.g. GNU make on macOS) is reachable
+$zigDir = ConvertTo-ShellPath (Split-Path (Get-Command zig).Source)
+$env:PV_EXTRA_PATH = [string]::IsNullOrEmpty($env:PV_EXTRA_PATH) ? $zigDir : "$env:PV_EXTRA_PATH`:$zigDir"
+
+$env:PV_ROOT = ConvertTo-ShellPath $workRoot
+$env:PV_SRC = ConvertTo-ShellPath $sourceDir
+$env:PV_SHIM = ConvertTo-ShellPath $shim
+$env:PV_OUT = ConvertTo-ShellPath $outputDir
+$env:MACHONM = $IsWindows ? (ConvertTo-ShellPath $machonm) : "nm"
+$buildScript = ConvertTo-ShellPath (Join-Path $scriptRoot "ffmpeg\build-target.sh")
+
+foreach ($target in $Targets) {
+    Write-Host ""
+    Write-Host "########## Building picview-ffmpeg for $target ##########" -ForegroundColor Cyan
+
+    if ($IsWindows) {
+        # MSYS2's login shell sets up the MINGW64 toolchain PATH
+        $env:MSYSTEM = "MINGW64"
+        $env:CHERE_INVOKING = "1"
+        & $bash -lc "bash '$buildScript' $target"
+    }
+    else {
+        & $bash "$buildScript" $target
+    }
+    if ($LASTEXITCODE -ne 0) { throw "Build failed for $target" }
+}
+
+Write-Host ""
+Write-Host "picview-ffmpeg build complete:" -ForegroundColor Green
+Get-ChildItem $outputDir -Recurse -File | ForEach-Object {
+    "{0,-45} {1,6:N2} MB" -f $_.FullName.Substring($repoRoot.Length), ($_.Length / 1MB)
+}