# heif-convert
Multi-Platform command line tool written in Python to convert HEIF images.
If you find heif-convert helpful, please consider giving it a star ⭐️. Your support helps me gauge its usage and motivates further development.
## 📝 Table of Contents
- [About](#about)
- [Installation](#installation)
- [Usage](#usage)
- [Arguments](#arguments)
- [Libraries](#libraries)
- [Supported operating systems](#supported-operating-systems)
- [License](#license)
## 📕 About <a name="about"></a>
heif-convert is a multi-platform tool written in Python to convert High Efficiency Image File (HEIF) images to jpg, png, webp, gif, tiff, bmp, or ico.
heif-convert is designed to make HEIF batch conversion easy.
## ⚙️ Installation <a name="installation"></a>
## Python repository
The easiest way to get heif-convert is through the pypi.org repository. Install it by running the following command:
```bash
pip install heif-convert
```
## Building from source
To install heif-convert from source, clone this repository and run `pip install .` as follows:
```bash
git clone https://github.com/NeverMendel/heif-convert.git
cd heif-convert
pip install .
```
## Docker image
To pull heif-convert Docker image, run:
```bash
docker pull nevermendel/heif-convert
```
## Usage
heif-convert can be used from the command line by invoking the `heif-convert` command.
Convert an HEIF image to a JPG image:
```bash
heif-convert input.heic -f jpg
```
Convert all HEIF images in the current folder to JPG images:
```bash
heif-convert *.heic -f jpg
```
### Docker image
Convert an HEIF image to PNG using the Docker image:
```bash
docker run -v "$(pwd)":/usr/app/out --rm nevermendel/heif-convert input.heic -f jpg
```
## Arguments
```
usage: heif-convert [-h] [-o OUTPUT] [-p PATH]
[-f {jpg,png,webp,gif,tiff,bmp,ico}] [-q QUALITY] [-n] [-v]
[-vv] [-V]
input [input ...]
Command line tool to convert HEIF images
positional arguments:
input HEIF input file(s)
options:
-h, --help show this help message and exit
-o OUTPUT, --output OUTPUT
output file name
defaults to original file name (default: '{name}')
-p PATH, --path PATH output file path
defaults to original file path (default: '{path}')
-f {jpg,png,webp,gif,tiff,bmp,ico}, --format {jpg,png,webp,gif,tiff,bmp,ico}
output format (default: jpg)
-q QUALITY, --quality QUALITY
output quality, integer [0, 100] (default: 90)
-n, --no-exif Do not include EXIF metadata in the converted image
-v, --verbose enable verbose logging
-vv, --extra-verbose enable extra verbose logging
-V, --version show program's version number and exit
```
## Libraries
heif-convert uses the following libraries:
- [Pillow](https://github.com/python-pillow/Pillow)
- [pillow_heif](https://github.com/bigcat88/pillow_heif)
## Supported operating systems
heif-convert works on Linux, Mac OS and Windows systems. For further information refer to the [pillow_heif](https://github.com/bigcat88/pillow_heif) repository.
## License
[MIT License](LICENSE)
Raw data
{
"_id": null,
"home_page": "https://github.com/NeverMendel/heif-convert",
"name": "heif-convert",
"maintainer": null,
"docs_url": null,
"requires_python": ">=3.7",
"maintainer_email": null,
"keywords": "heif, heic, heif-convert, heic-convert",
"author": "Davide Cazzin",
"author_email": "28535750+NeverMendel@users.noreply.github.com",
"download_url": "https://files.pythonhosted.org/packages/9a/4f/1898a033446d678e17dc72569bc555aa963ff47692fa0d33aaf6206bc472/heif_convert-1.2.1.tar.gz",
"platform": null,
"description": "# heif-convert\n\nMulti-Platform command line tool written in Python to convert HEIF images.\n\nIf you find heif-convert helpful, please consider giving it a star \u2b50\ufe0f. Your support helps me gauge its usage and motivates further development.\n\n## \ud83d\udcdd Table of Contents\n\n- [About](#about)\n- [Installation](#installation)\n- [Usage](#usage)\n- [Arguments](#arguments)\n- [Libraries](#libraries)\n- [Supported operating systems](#supported-operating-systems)\n- [License](#license)\n\n## \ud83d\udcd5 About <a name=\"about\"></a>\n\nheif-convert is a multi-platform tool written in Python to convert High Efficiency Image File (HEIF) images to jpg, png, webp, gif, tiff, bmp, or ico.\n\nheif-convert is designed to make HEIF batch conversion easy.\n\n## \u2699\ufe0f Installation <a name=\"installation\"></a>\n\n## Python repository\n\nThe easiest way to get heif-convert is through the pypi.org repository. Install it by running the following command:\n\n```bash\npip install heif-convert\n```\n\n## Building from source\n\nTo install heif-convert from source, clone this repository and run `pip install .` as follows:\n\n```bash\ngit clone https://github.com/NeverMendel/heif-convert.git\ncd heif-convert\npip install .\n```\n\n## Docker image\n\nTo pull heif-convert Docker image, run:\n\n```bash\ndocker pull nevermendel/heif-convert\n```\n\n## Usage\n\nheif-convert can be used from the command line by invoking the `heif-convert` command.\n\nConvert an HEIF image to a JPG image:\n\n```bash\nheif-convert input.heic -f jpg\n```\n\nConvert all HEIF images in the current folder to JPG images:\n\n```bash\nheif-convert *.heic -f jpg\n```\n\n### Docker image\n\nConvert an HEIF image to PNG using the Docker image:\n\n```bash\ndocker run -v \"$(pwd)\":/usr/app/out --rm nevermendel/heif-convert input.heic -f jpg\n```\n\n## Arguments\n\n```\nusage: heif-convert [-h] [-o OUTPUT] [-p PATH]\n [-f {jpg,png,webp,gif,tiff,bmp,ico}] [-q QUALITY] [-n] [-v]\n [-vv] [-V]\n input [input ...]\n\nCommand line tool to convert HEIF images\n\npositional arguments:\n input HEIF input file(s)\n\noptions:\n -h, --help show this help message and exit\n -o OUTPUT, --output OUTPUT\n output file name\n defaults to original file name (default: '{name}')\n -p PATH, --path PATH output file path\n defaults to original file path (default: '{path}')\n -f {jpg,png,webp,gif,tiff,bmp,ico}, --format {jpg,png,webp,gif,tiff,bmp,ico}\n output format (default: jpg)\n -q QUALITY, --quality QUALITY\n output quality, integer [0, 100] (default: 90)\n -n, --no-exif Do not include EXIF metadata in the converted image\n -v, --verbose enable verbose logging\n -vv, --extra-verbose enable extra verbose logging\n -V, --version show program's version number and exit\n```\n\n## Libraries\n\nheif-convert uses the following libraries:\n\n- [Pillow](https://github.com/python-pillow/Pillow)\n- [pillow_heif](https://github.com/bigcat88/pillow_heif)\n\n## Supported operating systems\n\nheif-convert works on Linux, Mac OS and Windows systems. For further information refer to the [pillow_heif](https://github.com/bigcat88/pillow_heif) repository.\n\n## License\n\n[MIT License](LICENSE)\n",
"bugtrack_url": null,
"license": "MIT",
"summary": "Multi-Platform command line tool written in Python to convert HEIF images",
"version": "1.2.1",
"project_urls": {
"Homepage": "https://github.com/NeverMendel/heif-convert"
},
"split_keywords": [
"heif",
" heic",
" heif-convert",
" heic-convert"
],
"urls": [
{
"comment_text": "",
"digests": {
"blake2b_256": "96e75dd9ae1774bf8349a4762a7887db78134e09eed64e1f047d0084e1d329de",
"md5": "a27d10271e0b8ef10ca94559ecf457da",
"sha256": "736398507263b041180962d9d2c5d30c95c52bb16b448286f2681897ab3c15b5"
},
"downloads": -1,
"filename": "heif_convert-1.2.1-py3-none-any.whl",
"has_sig": false,
"md5_digest": "a27d10271e0b8ef10ca94559ecf457da",
"packagetype": "bdist_wheel",
"python_version": "py3",
"requires_python": ">=3.7",
"size": 5435,
"upload_time": "2024-10-14T21:09:37",
"upload_time_iso_8601": "2024-10-14T21:09:37.825023Z",
"url": "https://files.pythonhosted.org/packages/96/e7/5dd9ae1774bf8349a4762a7887db78134e09eed64e1f047d0084e1d329de/heif_convert-1.2.1-py3-none-any.whl",
"yanked": false,
"yanked_reason": null
},
{
"comment_text": "",
"digests": {
"blake2b_256": "9a4f1898a033446d678e17dc72569bc555aa963ff47692fa0d33aaf6206bc472",
"md5": "fc7756de5c7b6c10fde035e0c59e457e",
"sha256": "33bab4d5aa6729867f5a7d27e49b9819b28827359ef7a80a3246efde4ab67e2b"
},
"downloads": -1,
"filename": "heif_convert-1.2.1.tar.gz",
"has_sig": false,
"md5_digest": "fc7756de5c7b6c10fde035e0c59e457e",
"packagetype": "sdist",
"python_version": "source",
"requires_python": ">=3.7",
"size": 4733,
"upload_time": "2024-10-14T21:09:39",
"upload_time_iso_8601": "2024-10-14T21:09:39.069228Z",
"url": "https://files.pythonhosted.org/packages/9a/4f/1898a033446d678e17dc72569bc555aa963ff47692fa0d33aaf6206bc472/heif_convert-1.2.1.tar.gz",
"yanked": false,
"yanked_reason": null
}
],
"upload_time": "2024-10-14 21:09:39",
"github": true,
"gitlab": false,
"bitbucket": false,
"codeberg": false,
"github_user": "NeverMendel",
"github_project": "heif-convert",
"travis_ci": false,
"coveralls": false,
"github_actions": true,
"requirements": [],
"lcname": "heif-convert"
}
JSON
