heic2png

A Flutter plugin that converts HEIC/HEIF images to PNG using native platform APIs. Fully offline, no third-party services -- just lossless conversion on-device.

Features #

• Lossless HEIC/HEIF to PNG conversion
• Convert to file or to in-memory bytes
• Configurable PNG compression level (0-9)
• Metadata preservation (ICC color profiles, EXIF data)
• Cross-platform: iOS, Android, macOS, Windows, Linux
• Uses native APIs on each platform for maximum performance:
  • iOS / macOS: CoreGraphics / ImageIO
  • Android: BitmapFactory + ExifInterface
  • Windows: Windows Imaging Component (WIC)
  • Linux: libheif + libpng

Installation #

dependencies:
  heic2png: ^0.0.1

iOS #

No additional setup needed (iOS 12.0+).

Android #

Requires Android 9 (API 28) or later (native HEIF decoder support).

Set minSdk = 28 in your app's android/app/build.gradle.kts:

android {
    defaultConfig {
        minSdk = 28
    }
}

macOS #

No additional setup needed (macOS 10.13+).

Windows #

Requires Windows 10 version 1809 or later. The HEIF Image Extensions from the Microsoft Store may be required on Windows 10; Windows 11 bundles the codec.

Linux #

Install the required native libraries:

sudo apt install libheif-dev libpng-dev

Usage #

Convert to a file #

import 'package:heic2png/heic2png.dart';

final success = await Heic2png.convert('/path/to/input.heic', '/path/to/output.png');
if (success) {
  print('Converted successfully!');
}

Convert to bytes #

final bytes = await Heic2png.convertToBytes('/path/to/input.heic');
if (bytes != null) {
  // Use the PNG bytes (e.g. display with Image.memory)
}

Compression level #

Control how much effort is spent compressing the output PNG. 0 is fastest (largest file), 9 is slowest (smallest file). Default is 6.

// Fastest conversion, larger file
await Heic2png.convert(input, output, compressionLevel: 0);

// Maximum compression, slower
await Heic2png.convert(input, output, compressionLevel: 9);

// Also works with convertToBytes
final bytes = await Heic2png.convertToBytes(input, compressionLevel: 9);

Metadata preservation #

By default, ICC color profiles and EXIF data (camera info, GPS, orientation, date/time) are preserved from the source HEIC file. Set preserveMetadata: false to strip all metadata:

// Strip all metadata (ICC profile, EXIF, GPS, etc.)
await Heic2png.convert(input, output, preserveMetadata: false);

// Combine options
final bytes = await Heic2png.convertToBytes(
  input,
  compressionLevel: 0,
  preserveMetadata: false,
);

API #

Parameters #

Platform notes #

Compression level #

Metadata preservation #

• iOS / macOS preserve all metadata (EXIF, ICC, GPS, TIFF tags, XMP) automatically via CGImageDestinationAddImageFromSource.
• Android transfers EXIF tags (camera info, GPS, orientation, date/time) via AndroidX ExifInterface. ICC color profile transfer is not supported -- colors are converted to sRGB during encoding.
• Windows preserves ICC color profiles via WIC color contexts. EXIF transfer across container formats is not supported.
• Linux preserves ICC profiles via png_set_iCCP and EXIF via png_set_eXIf_1 (requires libpng 1.6.32+). On older libpng versions, EXIF is silently skipped.

Example #

See the example app for a complete working demo.

License #

MIT -- see LICENSE for details.