Metadata-Version: 2.1
Name: heic-image-converter
Version: 1.0.0
Summary: Convert .HEIC Images!
Home-page: https://github.com/XDwightsBeetsX/heic-image-converter
Author: John Gutierrez
License: MIT
Keywords: image,image-processing,heic,heic-to-png
Platform: UNKNOWN
Classifier: Programming Language :: Python :: 3.8
Classifier: License :: OSI Approved :: MIT License
Requires-Python: >=3.8
Description-Content-Type: text/markdown
License-File: LICENSE

# Convert those Pesky `.HEIC` Images to Something More Useful!

i-Device images often come in `.heic` image file format, but these don't translate well to other uses...

I had a bunch of downloaded `.heic` files but wanted to convert them to `.png` format so I wrote this converter!

## Notes

- no suitable package was found to convert `.heic` ➡️ `.jpg` on Windows.
- panoramic or stretched images may not convert properly.
- skips already-converted files to prevent redundancy

## Usage

> *currently working on a PYPI release...*

1. ***Install required packages***
   1. `pip install pillow_heif`
   2. `pip install pillow` (or use default `PIL` - legacy)
   3. see [requirements.txt](./requirements.txt)
2. ***Download the repo*** [**`.zip`**](https://github.com/XDwightsBeetsX/image-converter/archive/refs/heads/master.zip)
3. Obtain the ***path to the python `main.py` program***
4. Obtain the ***path to the `.heic` image folder***
5. Use desired [flags](#flags)

## Examples

- Set the destination folder with `--dest`

  <img src="docs/img/sample_run1.png" style="width:800px; height:auto;" alt="set custom destination folder" title="set custom destination folder">

- Automatically delete converted files with `-del`

  <img src="docs/img/sample_run2.png" style="width:800px; height:auto;" alt="set delete flag" title="set delete flag">

## Flags

- double-hyphen '`--`' flags take arguments
- single-hyphen '`-`' flags are booleans

| Flag      | Options            | Description |
|  :-:      | :--                | :--         |
| `--to`    | `png`              | sets the desired type to convert the `.heic` files to. |
| `--dest`  | `path/to/saveDest` | choose the save location for the converted files. |
| `-del`    | `none`             | delete the original `.heic` file after successful conversions. |

> *if you have comments / suggestions / bug fixes, please make a github issue [here](https://github.com/XDwightsBeetsX/heic-image-converter/issues)*
> 
> *thanks for checking this project out :)*

