Skip to main content

Convert between image and High Efficiency Image (HEIC/AVIF) 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.3] - 2022-10-02

  • Fixed minor bug where the log does not appear properly when transcoding multiple formats.

[0.1.2] - 2022-10-02

  • Renamed he_jpg.py to he_img.py for better file type support.
  • Fixed a potential issue that can delete all JPG when using the old heiya.he_jpg.

[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.3.tar.gz (12.1 kB view details)

Uploaded Source

Built Distribution

heiya-0.1.3-py3-none-any.whl (12.9 kB view details)

Uploaded Python 3

File details

Details for the file heiya-0.1.3.tar.gz.

File metadata

  • Download URL: heiya-0.1.3.tar.gz
  • Upload date:
  • Size: 12.1 kB
  • Tags: Source
  • Uploaded using Trusted Publishing? No
  • Uploaded via: twine/4.0.1 CPython/3.8.13

File hashes

Hashes for heiya-0.1.3.tar.gz
Algorithm Hash digest
SHA256 1fe94a9465117414be3630c266885c8c6c81969db189cd7670e42c246bbf5fea
MD5 a3fc089d30b26d605dcd89e5ef57db96
BLAKE2b-256 d0e233d20a364120e92bd675a71e0ab43c8f5390c588006051d2e3bd409edc1d

See more details on using hashes here.

File details

Details for the file heiya-0.1.3-py3-none-any.whl.

File metadata

  • Download URL: heiya-0.1.3-py3-none-any.whl
  • Upload date:
  • Size: 12.9 kB
  • Tags: Python 3
  • Uploaded using Trusted Publishing? No
  • Uploaded via: twine/4.0.1 CPython/3.8.13

File hashes

Hashes for heiya-0.1.3-py3-none-any.whl
Algorithm Hash digest
SHA256 046d0a0a53068a647461d1ba50e6041e515ddd15cde78ba98589489700c4a163
MD5 fd89f5a9234f2b7e37bba356ea316016
BLAKE2b-256 4cbd39876d9aff799f879f8b9b00268e211feebeb0bb35453a0aed2305bc199b

See more details on using hashes here.

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