LibHeifSharp 3.0.0

There is a newer version of this package available.
See the version list below for details.
dotnet add package LibHeifSharp --version 3.0.0
NuGet\Install-Package LibHeifSharp -Version 3.0.0
This command is intended to be used within the Package Manager Console in Visual Studio, as it uses the NuGet module's version of Install-Package.
<PackageReference Include="LibHeifSharp" Version="3.0.0" />
For projects that support PackageReference, copy this XML node into the project file to reference the package.
paket add LibHeifSharp --version 3.0.0
#r "nuget: LibHeifSharp, 3.0.0"
#r directive can be used in F# Interactive and Polyglot Notebooks. Copy this into the interactive tool or source code of the script to reference the package.
// Install LibHeifSharp as a Cake Addin
#addin nuget:?package=LibHeifSharp&version=3.0.0

// Install LibHeifSharp as a Cake Tool
#tool nuget:?package=LibHeifSharp&version=3.0.0


libheif-sharp provides .NET bindings for libheif.
It is built against .NET Standard 2.0, and should work on any supported .NET platform that has a libheif shared library.


  • Supports decoding
    • Top-level images
    • Thumbnails
    • Depth images
    • Vendor-specific auxiliary images
  • Supports encoding
    • Top-level images
    • Thumbnails
  • Supports reading and writing meta-data


API Documentation
Building libheif on Windows with vcpkg

Sample Applications

The libheif-sharp-samples repository contains sample applications that demonstrate the use of the library.


The libheif shared library must be named libheif in order for it to be found by P/Invoke.

The minimum supported libheif version is 1.9.0.

Product Compatible and additional computed target framework versions.
.NET net5.0 was computed.  net5.0-windows was computed.  net6.0 was computed.  net6.0-android was computed.  net6.0-ios was computed.  net6.0-maccatalyst was computed.  net6.0-macos was computed.  net6.0-tvos was computed.  net6.0-windows was computed.  net7.0 was computed.  net7.0-android was computed.  net7.0-ios was computed.  net7.0-maccatalyst was computed.  net7.0-macos was computed.  net7.0-tvos was computed.  net7.0-windows was computed.  net8.0 was computed.  net8.0-android was computed.  net8.0-browser was computed.  net8.0-ios was computed.  net8.0-maccatalyst was computed.  net8.0-macos was computed.  net8.0-tvos was computed.  net8.0-windows was computed. 
.NET Core netcoreapp2.0 was computed.  netcoreapp2.1 was computed.  netcoreapp2.2 was computed.  netcoreapp3.0 was computed.  netcoreapp3.1 was computed. 
.NET Standard netstandard2.0 is compatible.  netstandard2.1 was computed. 
.NET Framework net461 was computed.  net462 was computed.  net463 was computed.  net47 was computed.  net471 was computed.  net472 was computed.  net48 was computed.  net481 was computed. 
MonoAndroid monoandroid was computed. 
MonoMac monomac was computed. 
MonoTouch monotouch was computed. 
Tizen tizen40 was computed.  tizen60 was computed. 
Xamarin.iOS xamarinios was computed. 
Xamarin.Mac xamarinmac was computed. 
Xamarin.TVOS xamarintvos was computed. 
Xamarin.WatchOS xamarinwatchos was computed. 
Compatible target framework(s)
Included target framework(s) (in package)
Learn more about Target Frameworks and .NET Standard.
  • .NETStandard 2.0

    • No dependencies.

NuGet packages (1)

Showing the top 1 NuGet packages that depend on LibHeifSharp:

Package Downloads

HEIF/AVIF decoder for ImageSharp

GitHub repositories

This package is not used by any popular GitHub repositories.

Version Downloads Last updated
3.2.0 10,955 11/20/2023
3.1.0 6,318 5/16/2023
3.0.0 19,575 2/28/2023
2.4.0 14,720 9/10/2022
2.3.1 805 9/9/2022
2.3.0 774 9/4/2022
2.2.0 5,028 2/23/2022
2.1.0 40,113 5/20/2021
2.0.2 926 12/30/2020
2.0.1 825 11/25/2020
2.0.0 874 11/11/2020
1.0.0 958 10/21/2020

v3.0.0 - 2023-02-28
## Breaking

* All obsolete members will produce a compiler error.
* Removed the .NET Standard 1.3 and .NET Framework 4.6 targets.

## Added

* A GetDecoderDescriptors method to the LibHeifInfo class.
 - Requires LibHeif version 1.15.0 or later, it returns an empty collection on older versions.
* A DecoderId property to the HeifDecodingOptions class.
 - This instructs LibHeif to use a specific decoder when reading the image.
 - Requires LibHeif version 1.15.0 or later, it is ignored on older versions.
* A HaveVersion method to the LibHeifInfo class.
 - This simplifies checking that LibHeif is at least the specified minimum version.
* IccColorProfile and NclxColorProfile properties to the HeifImageHandle class.
* A GetMetadataBlockInfo method to the HeifImageHandle class.
* A ContentLightLevel property to the HeifImage class.
 - The content light level data is used for HDR rendering.
 - Requires LibHeif version 1.15.0 or later.
* A MasteringDisplayColourVolume property to the HeifImage class.
 - The mastering display color volume data is used for HDR rendering.
 - Requires LibHeif version 1.15.0 or later.
* A PixelAspectRatio property to the HeifImage class.
 - Requires LibHeif version 1.15.0 or later.
* An ImageOrientation property to the HeifEncodingOptions class.
 - This property allows the encoder to convert the EXIF Orientation values into the equivalent HEIF image transformations.
 - Requires LibHeif version 1.14.0 or later, it is ignored on older versions.

## Changed

* GetDepthRepresentationInfo throws an exception when the nonlinear representation model is larger than 2GB.
 - Previous versions of this library would silently ignore a nonlinear representation model that is larger than 2GB.