Metadata-Version: 2.1
Name: heiya
Version: 0.1.2
Summary: Convert between image and High Efficiency Image (HEIC/AVIF) with ease.
Home-page: https://github.com/wu-hongjun/heiya
Download-URL: https://pypi.org/project/heiya/
Author: Hongjun Wu
Author-email: hw434@cornell.edu
License: Apache License 2.0
Keywords: HEIC,AVIF,TIFF,JPG,ImageConversion
Description-Content-Type: text/markdown
License-File: LICENSE.txt

# 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](https://www.winxdvd.com/ios-android-mobile/avif-vs-heic.htm)). 
* 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.
  
```python
pip install heiya
pip install heiya --upgrade
```

## Examples

A complete set of heiya examples can be found in the [Heiya Demo Notebook](https://github.com/wu-hongjun/heiya/blob/main/heiya_demo.ipynb).



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