{"id":27350258,"url":"https://github.com/nevermendel/heif-convert","last_synced_at":"2026-03-10T04:03:24.806Z","repository":{"id":142632462,"uuid":"612686795","full_name":"NeverMendel/heif-convert","owner":"NeverMendel","description":"Multi-Platform command line tool written in Python to convert HEIF images","archived":false,"fork":false,"pushed_at":"2024-11-17T13:54:19.000Z","size":26113,"stargazers_count":27,"open_issues_count":0,"forks_count":6,"subscribers_count":1,"default_branch":"master","last_synced_at":"2024-11-17T14:44:49.105Z","etag":null,"topics":["collaborate","github","github-codespaces","heic","heic-convert","heic-converter","heic-to-jpg","heic-to-png","heif","heif-convert","heif-converter","python","student-vscode"],"latest_commit_sha":null,"homepage":"","language":"Python","has_issues":true,"has_wiki":null,"has_pages":null,"mirror_url":null,"source_name":null,"license":"mit","status":null,"scm":"git","pull_requests_enabled":true,"icon_url":"https://github.com/NeverMendel.png","metadata":{"files":{"readme":"README.md","changelog":null,"contributing":"CONTRIBUTING.md","funding":null,"license":"LICENSE","code_of_conduct":null,"threat_model":null,"audit":null,"citation":null,"codeowners":null,"security":null,"support":null,"governance":null,"roadmap":null,"authors":null,"dei":null,"publiccode":null,"codemeta":null}},"created_at":"2023-03-11T17:22:24.000Z","updated_at":"2024-11-17T13:54:23.000Z","dependencies_parsed_at":null,"dependency_job_id":"6884e855-c8d2-4af8-9bd8-e33fb056e2da","html_url":"https://github.com/NeverMendel/heif-convert","commit_stats":null,"previous_names":[],"tags_count":5,"template":false,"template_full_name":null,"repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/NeverMendel%2Fheif-convert","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/NeverMendel%2Fheif-convert/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/NeverMendel%2Fheif-convert/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/NeverMendel%2Fheif-convert/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/NeverMendel","download_url":"https://codeload.github.com/NeverMendel/heif-convert/tar.gz/refs/heads/master","host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":248624358,"owners_count":21135433,"icon_url":"https://github.com/github.png","version":null,"created_at":"2022-05-30T11:31:42.601Z","updated_at":"2022-07-04T15:15:14.044Z","host_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub","repositories_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories","repository_names_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repository_names","owners_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners"}},"keywords":["collaborate","github","github-codespaces","heic","heic-convert","heic-converter","heic-to-jpg","heic-to-png","heif","heif-convert","heif-converter","python","student-vscode"],"created_at":"2025-04-12T19:39:02.035Z","updated_at":"2026-03-10T04:03:24.773Z","avatar_url":"https://github.com/NeverMendel.png","language":"Python","funding_links":[],"categories":[],"sub_categories":[],"readme":"# 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 ⭐️. Your support helps me gauge its usage and motivates further development.\n\n## 📝 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## 📕 About \u003ca name=\"about\"\u003e\u003c/a\u003e\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## ⚙️ Installation \u003ca name=\"installation\"\u003e\u003c/a\u003e\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\n```\n\nConvert all HEIF images in the current folder to JPG images:\n\n```bash\nheif-convert *.heic\n```\n\n### Docker image\n\nConvert an HEIF image to JPG using the Docker image:\n\n```bash\ndocker run -v \"$(pwd)\":/usr/app/out --rm nevermendel/heif-convert input.heic\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)","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fnevermendel%2Fheif-convert","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Fnevermendel%2Fheif-convert","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fnevermendel%2Fheif-convert/lists"}