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.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.2.tar.gz (11.9 kB view details)

Uploaded Source

Built Distribution

heiya-0.1.2-py3-none-any.whl (12.8 kB view details)

Uploaded Python 3

File details

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

File metadata

  • Download URL: heiya-0.1.2.tar.gz
  • Upload date:
  • Size: 11.9 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.2.tar.gz
Algorithm Hash digest
SHA256 791a4d6269a01f06405a6dc959d40168a343ef3775b0502c31ba40b47f0e9e1d
MD5 1f5f647e86821c6cdda0a7aefbb8c000
BLAKE2b-256 fc5a160a4f280fe09cfb7e56edea41caeec9f9d54a32d8840baf6953d976134b

See more details on using hashes here.

File details

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

File metadata

  • Download URL: heiya-0.1.2-py3-none-any.whl
  • Upload date:
  • Size: 12.8 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.2-py3-none-any.whl
Algorithm Hash digest
SHA256 1fcb65699ffea429457658ff695a3a39db90a2873d03abcc3df7db3f5f3af907
MD5 1930ed38d3a2de1e8ae0b87cebbfa60a
BLAKE2b-256 e4dc2494491d0e140e2b82dbb7dcf2fc717394d04d51f30279fc0c02fa7970e4

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