heiya 0.1.0

Convert image to High Efficiency Image (HEIC/AVIF) and back with ease.

Heiya

A one line solution for photographers who are looking to replace their JPEGs with High Efficiency Images(HEIs).

Introduction

High Efficiency Image (HEI) - Ya!

Get it?

It is unbelieveable that JPEG is from... last century. And the majority of cameras in the current age shoot JPG. Some can encode using HEIC (iPhone, Fujifilm X-H2S, ...), but that codec is inside a paywall. Most cameras do not support AVIF, but it is the future for image codec and many operating system already support AV1 (and therefore AVIF).

HEIC and AVIF are what is called "High Efficiency Images", and can result in file size 10x less than traditional JPEGs. However, there is no easy solution to simply convert JPEG/TIFF to HEIC/AVIF and preserve all the metadata.

Heiya is an open source wrapper for easy High Efficiency Image (AVIF/HEIC) to and from JPG conversion. It is developed for photographers to build a more automatic and space saving pipeline.

System Requirements

Heiya is developed on macOS and isn't tested on Windows or other OS such as Linux.

Install Heiya

Install from PIP

pip install heiya

Upgrade from PIP

pip install heiya --upgrade

Examples

Getting Started

import heiya

Define Source Directory

# Option 1: Define it by yourself
source_dir = ""

# Option 2: Get the directory directly from the clipboard
import pyperclip as clip

if source_dir == "":
    source_dir = clip.paste()

Batch JPG/TIF -> HEI in directory

heiya.to_hei.convert_image_in_dir(source_dir, source_tif=False, source_jpg=True, 
                                  target_hif=False, target_avif=True)

Batch IMG -> HEI in directory using depth

Example: 
    /Photos/2022/01/20220105/img1.jpg, ...
    Then with source_dir = "/Photos":
        depth = 0 -> "/Photos"
        depth = 1 -> "/Photos/2022"
        depth = 2 -> "/Photos/2022/01"
        depth = 3 -> "/Photos/2022/01/20220105"

heiya.to_hei.convert_all_sub_folders_to_hei(source_dir, source_tif=False, source_jpg=False, 
                                            target_hif=False, target_avif=False, depth=2)

Batch HEI -> JPG in directory

heiya.from_hei.convert_hei_in_dir_to_jpg(source_dir, source_hif=False, 
                                         source_avif=False, fix_rotation=True)

Batch JPG -> HEI -> JPG in directory

heiya.tools.convert_jpg_to_he_jpg(source_dir, use_hif=False, 
                                  use_avif=True, preserve_original_jpg=True)

Delete files with a specific extension in directory

heiya.tools.delete_image_in_dir(source_dir, tif=False, jpg=False, hif=False, avif=False)

Change log

NOTE: Not production ready yet.

[0.1.0] - 2022-10-02

• Attempting to fix an issue of incorrect param call from heiya.he_jpg.convert_jpg_to_he_jpg.

[0.0.9] - 2022-10-02

• Unsuccessful fix for an issue of incorrect param call from heiya.he_jpg.convert_jpg_to_he_jpg.

[0.0.8] - 2022-10-02

• Standarized function names for from_hei and to_hei.

[0.0.7] - 2022-10-02

• Fixed an issue of internal packages not being able to properly import.

[0.0.6] - 2022-10-02

• Added extensions and tools to __init__.py to fix referencing issue.

[0.0.5] - 2022-10-02

• Removed the requirement for glob.

[0.0.4] - 2022-10-02

• Removed the requirement for os.

[0.0.3] - 2022-10-02

• Code cleanup.

[0.0.2] - 2022-10-02

• Initial upload.

[0.0.1] - 2022-10-01

• Created the project.