HEIC to DDW Builder

Convert a single multi-frame HEIC/HEIF file into a WinDynamicDesktop .ddw theme package with four phases:

• sunriseImageList
• dayImageList
• sunsetImageList
• nightImageList

The tool exports frames as img0.png, img1.png, ... and creates theme.json using WinDynamicDesktop-compatible fields.

Stack

• .NET console app (net10.0)
• Magick.NET-Q8-AnyCPU for HEIC decoding and PNG conversion
• System.IO.Compression for packaging .ddw

Build

dotnet build src/DdwBuilder

Usage

dotnet run --project src/DdwBuilder -- --input "D:\wallpapers\scene.heic"

Options

• --input <path> (required): multi-frame .heic / .heif
• --output <path>: output file path (default: <input-name>.ddw)
• --name <display name>: theme display name
• --theme-id <id>: theme ID slug in JSON
• --credits <text>: imageCredits value
• --sunrise-count <n>
• --day-count <n>
• --sunset-count <n>
• --night-count <n>
• --keep-temp: keep intermediate temp folder for debugging

If phase counts are omitted, the tool auto-splits frames by 15% / 35% / 15% / 35%. If any phase count is supplied, all four must be supplied and must sum to total frames.

Output

The generated .ddw contains:

• theme.json
• img*.png frame files

Import the .ddw directly in WinDynamicDesktop.

Notes

• Requires at least 4 frames in the HEIC file.
• If HEIC decode fails due missing delegate support, use a Magick.NET runtime/build that includes HEIC support.