Skip to main content

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

Project description

Heiya

A one-line solution for photographers to simply convert JPEG into HEIC/AVIF and preserve all the metadata.

Introduction

Heiya allows you to easily translate between JPG/TIFF and HEIC/AVIF, without losing image metadata such as geotag and lens information. All the common operations can be done using one line of code.

It is developed for photographers with a storage budget (like myself, lol) to build an automatic and efficient image storage pipeline.


JPEG was invented six years before my existence. And yet, the majority of cameras in the current age still shoot JPEG.

HEIC and AVIF are what are called "High-Efficiency Images" (You can read about them here: AVIF vs HEIC).

  • These are the future of media formats, JPEG is getting deprecated.
  • They can result in a file size of as much as 100x less than traditional JPEGs.
  • Devices and operating systems now have good support for both formats.
  • However, there are no free and easy-to-use tools out there to simply encode all the JPEGs my camera took into AVIFs while preserving metadata.

Install Heiya from PyPI

  • Heiya is developed on macOS and hasn't been tested on Windows or other OS such as Linux.
pip install heiya
pip install heiya --upgrade

Examples

A complete set of heiya examples can be found in the Heiya Demo Notebook.

Change log

NOTE: Not production ready yet.

[0.1.1] - 2022-10-02

  • Wrote a more intuitive READEME.md, and updated haiya_demo.ipynb on Github.

[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.

Project details


Download files

Download the file for your platform. If you're not sure which to choose, learn more about installing packages.

Source Distribution

heiya-0.1.1.tar.gz (11.5 kB view hashes)

Uploaded Source

Built Distribution

heiya-0.1.1-py3-none-any.whl (12.5 kB view hashes)

Uploaded Python 3

Supported by

AWS AWS Cloud computing and Security Sponsor Datadog Datadog Monitoring Fastly Fastly CDN Google Google Download Analytics Microsoft Microsoft PSF Sponsor Pingdom Pingdom Monitoring Sentry Sentry Error logging StatusPage StatusPage Status page