https://github.com/hoppergee/heic-to

Convert HEIC/HEIF images to JPEG, PNG in browser
https://github.com/hoppergee/heic-to

heic-to-jpeg heic-to-png heif-converter image-conversion

Last synced: about 11 hours ago
JSON representation

Convert HEIC/HEIF images to JPEG, PNG in browser

• Host: GitHub
• URL: https://github.com/hoppergee/heic-to
• Owner: hoppergee
• Created: 2024-08-07T14:53:33.000Z (5 months ago)
• Default Branch: main
• Last Pushed: 2024-12-07T17:37:23.000Z (16 days ago)
• Last Synced: 2024-12-16T12:27:27.921Z (7 days ago)
• Topics: heic-to-jpeg, heic-to-png, heif-converter, image-conversion
• Language: JavaScript
• Homepage:
• Size: 6.48 MB
• Stars: 93
• Watchers: 3
• Forks: 2
• Open Issues: 1
• Metadata Files:
  • Readme: README.md

Awesome Lists containing this project

README

        
# heic-to

Convert HEIC/HEIF images to JPEG, PNG in browser using Javascript.

Inspired by [heic2any](https://github.com/alexcorvi/heic2any) and [libheif-web](https://github.com/joutvhu/libheif-web). The purpose of heic-to is to continuously follow up on releases of [libheif](https://github.com/strukturag/libheif) to be able to preview HEIC/HEIF images in browser.

Currently, heic-to is using [libheif 1.19.5](https://github.com/strukturag/libheif/releases/tag/v1.19.5) under the hood. 

| Release  | libheif  |

| -------- | -------- |

| 1.1.5    | 1.19.5   | 

| 1.1.4    | 1.19.4   | 

| 1.1.3    | 1.19.3   | 

| 1.1.2    | 1.19.2   | 

| 1.1.1    | 1.19.1   | 

| 1.1.0    | 1.19.0   | 

| 1.0.3    | 1.18.2   |

| 1.0.2    | 1.18.2   |

| 1.0.1    | 1.18.2   |

| 1.0.0    | 1.18.1   |

### Usage

#### Check whether the image is HEIC or not 

```js

import { isHeic } from "heic-to"

const file = field.files[0]

await isHeic(file)

```

#### Convert HEIC to JPEG/PNG

```js

import { heicTo } from "heic-to"

const file = field.files[0]

const jpeg = await heicTo({

  blob: file,

  type: "image/jpeg",

  quality: 0.5

})

const png = await heicTo({

  blob: file,

  type: "image/png",

  quality: 0.5

})

```

### Development guide

#### How to fast test your changes on local?

```bash

yarn s

```

This will open `http://127.0.0.1:8080/example/` for easy testing.

#### How to build libheif.js from [libheif](https://github.com/strukturag/libheif) on Mac

```bash

brew install cmake make pkg-config x265 libde265 libjpeg libtool

brew install emscripten

git clone [email protected]:strukturag/libheif.git

```

Did below changes from `build-emscripten.sh`

```diff

# EXPORTED_FUNCTIONS=$($EMSDK/upstream/bin/llvm-nm $LIBHEIFA --format=just-symbols | grep "^heif_\|^de265_\|^aom_" | grep "[^:]$" | sed 's/^/_/' | paste -sd "," -)

EXPORTED_FUNCTIONS=$(/opt/homebrew/opt/llvm/bin/llvm-nm $LIBHEIFA --format=just-symbols | grep "^heif_\|^de265_\|^aom_" | grep "[^:]$" | sed 's/^/_/' | paste -sd "," -)

```

Start building

```bash

cd libheif

mkdir buildjs

cd buildjs

USE_WASM=0 ../build-emscripten.sh ..

```