heic-convert

Convert HEIC/HEIF images to JPEG and PNG

Install

1npm install heic-convert

Usage in NodeJS

Convert the main image in a HEIC to JPEG

1const { promisify } = require('util');
2const fs = require('fs');
3const convert = require('heic-convert');
4
5(async () => {
6  const inputBuffer = await promisify(fs.readFile)('/path/to/my/image.heic');
7  const outputBuffer = await convert({
8    buffer: inputBuffer, // the HEIC file buffer
9    format: 'JPEG',      // output format
10    quality: 1           // the jpeg compression quality, between 0 and 1
11  });
12
13  await promisify(fs.writeFile)('./result.jpg', outputBuffer);
14})();

Convert the main image in a HEIC to PNG

1const { promisify } = require('util');
2const fs = require('fs');
3const convert = require('heic-convert');
4
5(async () => {
6  const inputBuffer = await promisify(fs.readFile)('/path/to/my/image.heic');
7  const outputBuffer = await convert({
8    buffer: inputBuffer, // the HEIC file buffer
9    format: 'PNG'        // output format
10  });
11
12  await promisify(fs.writeFile)('./result.png', outputBuffer);
13})();

Convert all images in a HEIC

1const { promisify } = require('util');
2const fs = require('fs');
3const convert = require('heic-convert');
4
5(async () => {
6  const inputBuffer = await promisify(fs.readFile)('/path/to/my/image.heic');
7  const images = await convert.all({
8    buffer: inputBuffer, // the HEIC file buffer
9    format: 'JPEG'       // output format
10  });
11
12  for (let idx in images) {
13    const image = images[idx];
14    const outputBuffer = await image.convert();
15    await promisify(fs.writeFile)(`./result-${idx}.jpg`, outputBuffer);
16  }
17})();

The work to convert an image is done when calling image.convert(), so if you only need one of the images in a multi-image file, you can convert just that one from the images array and skip doing any work for the remaining images.

Note that while the converter returns a Promise and is overall asynchronous, a lot of work is still done synchronously, so you should consider using a worker thread in order to not block the main thread in highly concurrent production environments.

Usage in the browser

While the NodeJS version of heic-convert may be compiled for use in the browser with something like webpack, not all build tools necessarily like to compile all modules well. However, what further complicates things is that this module uses pure-javascript implementations of a jpeg and png encoder. But the browser has its own native encoders! Let's just use those instead of including a ton of extra code in your bundle.

When compiling a client-side project, use:

1const convert = require('heic-convert/browser');

This is currently only supported in the main thread. Support for workers may be added in the future, but if you need it sooner, please create an issue or even a PR!

Related

• heic-cli - convert heic/heif images to jpeg or png from the command line
• heic-decode - decode heic images to raw image data
• libheif-js - libheif as a pure-javascript npm module