# HEIC2PNG
[](https://github.com/NatLee/HEIC2PNG/actions/workflows/test.yml)
[](https://github.com/NatLee/HEIC2PNG/actions/workflows/release.yml)
This is a tool for converting the format of HEIC images to PNG using Python. It now supports quality adjustment and has an option to overwrite existing files, enhancing the flexibility and usability of the tool.
## Installation
```bash
pip install heic2png
```
Visit [HEIC2PNG on PyPI](https://pypi.org/project/HEIC2PNG/) for more details.
## Usage
### As a Library
You can use HEIC2PNG in your Python code as shown below:
```python
from heic2png import HEIC2PNG
if __name__ == '__main__':
heic_img = HEIC2PNG('test.heic', quality=90) # Specify the quality of the converted image
heic_img.save() # The converted image will be saved as `test.png`
```
### Command Line Interface
HEIC2PNG also provides a CLI for easy conversion of HEIC images to PNG. Here are some examples:
Convert a HEIC image to PNG with a specified output path:
```bash
heic2png -i test.heic -o test.png -q 90 # -q is used to specify the quality
```
If you want to keep the original name, use the command below. It will generate `test.png` for you:
```bash
heic2png -i test.heic -q 90
```
To overwrite an existing PNG file, use the `-w`` flag:
```bash
heic2png -i test.heic -o test.png -q 90 -w
```
## References
- [Example PyPi Package](https://github.com/tomchen/example_pypi_package)
- [Pillow HEIF](https://github.com/bigcat88/pillow_heif)
- [pngquant](https://pngquant.org/)
Raw data
{
"_id": null,
"home_page": "https://github.com/natlee/HEIC2PNG",
"name": "HEIC2PNG",
"maintainer": "",
"docs_url": null,
"requires_python": ">=3.7",
"maintainer_email": "",
"keywords": "HEIC,PNG,converter,image",
"author": "Nat Lee",
"author_email": "natlee.work@gmail.com",
"download_url": "https://files.pythonhosted.org/packages/ef/20/4f8ee989c37c8e143260569448cc4d3447ebc5bf794144e5c9cb0aba9185/HEIC2PNG-1.1.4.tar.gz",
"platform": null,
"description": "# HEIC2PNG\n\n[](https://github.com/NatLee/HEIC2PNG/actions/workflows/test.yml)\n[](https://github.com/NatLee/HEIC2PNG/actions/workflows/release.yml)\n\nThis is a tool for converting the format of HEIC images to PNG using Python. It now supports quality adjustment and has an option to overwrite existing files, enhancing the flexibility and usability of the tool.\n\n## Installation\n\n```bash\npip install heic2png\n```\n\nVisit [HEIC2PNG on PyPI](https://pypi.org/project/HEIC2PNG/) for more details.\n\n## Usage\n\n### As a Library\n\nYou can use HEIC2PNG in your Python code as shown below:\n\n```python\nfrom heic2png import HEIC2PNG\n\nif __name__ == '__main__':\n heic_img = HEIC2PNG('test.heic', quality=90) # Specify the quality of the converted image\n heic_img.save() # The converted image will be saved as `test.png`\n```\n\n### Command Line Interface\n\nHEIC2PNG also provides a CLI for easy conversion of HEIC images to PNG. Here are some examples:\n\nConvert a HEIC image to PNG with a specified output path:\n\n```bash\nheic2png -i test.heic -o test.png -q 90 # -q is used to specify the quality\n```\n\nIf you want to keep the original name, use the command below. It will generate `test.png` for you:\n\n```bash\nheic2png -i test.heic -q 90\n```\n\nTo overwrite an existing PNG file, use the `-w`` flag:\n\n```bash\nheic2png -i test.heic -o test.png -q 90 -w\n```\n## References\n\n- [Example PyPi Package](https://github.com/tomchen/example_pypi_package)\n- [Pillow HEIF](https://github.com/bigcat88/pillow_heif)\n- [pngquant](https://pngquant.org/)\n",
"bugtrack_url": null,
"license": "",
"summary": "Convert format of HEIC image to PNG by using Python.",
"version": "1.1.4",
"project_urls": {
"Bug Reports": "https://github.com/natlee/HEIC2PNG/issues",
"Documentation": "https://github.com/natlee/HEIC2PNG",
"Homepage": "https://github.com/natlee/HEIC2PNG",
"Source Code": "https://github.com/natlee/HEIC2PNG"
},
"split_keywords": [
"heic",
"png",
"converter",
"image"
],
"urls": [
{
"comment_text": "",
"digests": {
"blake2b_256": "6cee14d93530c6d2a5fe6664a7a7185b519dfb8b2c9d36bbe11e7e5302d6a4b7",
"md5": "4e2d12264373408ffa4eba1a54e4a0f1",
"sha256": "7a4b2e0d7ab44d4f9bd501e0a685db7a581321c2dabdb8345f16bdb1c4b70990"
},
"downloads": -1,
"filename": "HEIC2PNG-1.1.4-py3-none-any.whl",
"has_sig": false,
"md5_digest": "4e2d12264373408ffa4eba1a54e4a0f1",
"packagetype": "bdist_wheel",
"python_version": "py3",
"requires_python": ">=3.7",
"size": 5386,
"upload_time": "2023-11-21T03:46:47",
"upload_time_iso_8601": "2023-11-21T03:46:47.722705Z",
"url": "https://files.pythonhosted.org/packages/6c/ee/14d93530c6d2a5fe6664a7a7185b519dfb8b2c9d36bbe11e7e5302d6a4b7/HEIC2PNG-1.1.4-py3-none-any.whl",
"yanked": false,
"yanked_reason": null
},
{
"comment_text": "",
"digests": {
"blake2b_256": "ef204f8ee989c37c8e143260569448cc4d3447ebc5bf794144e5c9cb0aba9185",
"md5": "5c702e0cb06847298874e0b3d4600f8d",
"sha256": "9cc7c8a3351ba7b48d5c088aac9831f3a41d104ee218224fd871d19bb356074e"
},
"downloads": -1,
"filename": "HEIC2PNG-1.1.4.tar.gz",
"has_sig": false,
"md5_digest": "5c702e0cb06847298874e0b3d4600f8d",
"packagetype": "sdist",
"python_version": "source",
"requires_python": ">=3.7",
"size": 5587,
"upload_time": "2023-11-21T03:46:49",
"upload_time_iso_8601": "2023-11-21T03:46:49.273348Z",
"url": "https://files.pythonhosted.org/packages/ef/20/4f8ee989c37c8e143260569448cc4d3447ebc5bf794144e5c9cb0aba9185/HEIC2PNG-1.1.4.tar.gz",
"yanked": false,
"yanked_reason": null
}
],
"upload_time": "2023-11-21 03:46:49",
"github": true,
"gitlab": false,
"bitbucket": false,
"codeberg": false,
"github_user": "natlee",
"github_project": "HEIC2PNG",
"travis_ci": false,
"coveralls": false,
"github_actions": true,
"tox": true,
"lcname": "heic2png"
}
JSON
