PHPackages maestroerror/heif-converter - PHPackages - PHPackages [Skip to content](#main-content)[PHPackages](/)[Directory](/)[Categories](/categories)[Trending](/trending)[Leaderboard](/leaderboard)[Changelog](/changelog)[Analyze](/analyze)[Collections](/collections)[Log in](/login)[Sign up](/register) 1. [Directory](/) 2. / 3. [CLI & Console](/categories/cli) 4. / 5. maestroerror/heif-converter ActiveLibrary[CLI & Console](/categories/cli) maestroerror/heif-converter =========================== versatile command-line application, along with a Docker image, that offers an easy and efficient way to convert HEIC (and AVIF) images to other common formats like JPEG and PNG 0.2(2y ago)6730.2k↑11.3%2[2 issues](https://github.com/MaestroError/heif-converter-image/issues)1MITGo Since Jun 3Pushed 2y ago1 watchersCompare [ Source](https://github.com/MaestroError/heif-converter-image)[ Packagist](https://packagist.org/packages/maestroerror/heif-converter)[ RSS](/packages/maestroerror-heif-converter/feed)WikiDiscussions maestro Synced 1mo ago READMEChangelog (2)DependenciesVersions (3)Used By (1) heif-converter-image ==================== [](#heif-converter-image) heif-converter is a versatile command-line application, along with a Docker image, that offers an easy and efficient way to convert HEIC (and AVIF) images to other common formats like JPEG and PNG, and vice versa. It leverages the go-libheif module, a GoLang wrapper for the libheif library. This tool can be used as a standalone CLI application across various platforms including macOS, Linux, and Windows, or used via a Docker container, making it a flexible solution for all your HEIC image conversion needs. Installing dependencies ----------------------- [](#installing-dependencies) heif-converter relies on [libheif](https://github.com/strukturag/libheif), which must be installed on your system. To simplify the installation process, I've provided ready-to-use scripts for different operating systems:: - install-libheif.sh - install-libheif-macos.sh - install-libheif-windows.bat *note: these scripts assume that the required tools (such as **git** and **brew** for macOS or **git** and **Visual Studio with C++ Desktop development** for Windows) are already installed on the system.* Using from docker ----------------- [](#using-from-docker) In case you find hard to install libheif, you can use docker. Just Pull [docker image](https://hub.docker.com/r/maestroerror/heif-converter): ``` docker pull maestroerror/heif-converter:latest ``` To run the converter and convert an image: ``` docker run --rm -v /path/to/your/files:/app/files maestroerror/heif-converter [heic|avif|jpeg|png] /app/files/input_file /app/files/output_file ``` *Note: replace /path/to/your/files with the path to the directory containing the images you want to convert. The converter will look for the input file in this directory and will also write the output file to this directory.* ### Usage via Composer [](#usage-via-composer) You can also use heif-converter via Composer, a dependency manager for PHP. First, you need to add heif-converter to your project's dependencies. Navigate to your project's root directory in your terminal and run the following command: ``` composer require maestroerror/heif-converter ``` After installing the heif-converter, you can find the executable in the vendor/bin directory. Depending on your operating system, use the appropriate version: - Linux: `./vendor/bin/heif-converter-linux` - Windows: `./vendor/bin/heif-converter-windows` - MacOS: `./vendor/bin/heif-converter-macos` For example, to convert an image on a Linux system, you can run: ``` ./vendor/bin/heif-converter-linux heic input.heic output.png ``` #### Running Installation Script [](#running-installation-script) Before using the heif-converter, you may need to run the installation script for your platform. These scripts install the necessary dependencies (libheif). For Linux, run install-libheif.sh: ``` ./vendor/maestroerror/heif-converter/install-libheif.sh ``` For MacOS, run install-libheif-macos.sh: ``` ./vendor/maestroerror/heif-converter/install-libheif-macos.sh ``` For Windows, you need to use the command prompt to run install-libheif-windows.bat: ``` .\vendor\maestroerror\heif-converter\install-libheif-windows.bat ``` After running the appropriate script, you should be able to use the heif-converter command as explained in next chapter. To ensure your installation is ready to use run `./vendor/bin/heif-converter-linux` command without arguments, you should get output like this: ``` Usage: ./vendor/bin/heif-converter-linux [heic|avif|jpeg|png] input_file output_file ``` Usage ----- [](#usage) Just point to the executable (`./heif-converter`), add the current image format (`[heic|avif|jpeg|png]`) as the first argument and input / output files as the second and third arguments. ``` ./heif-converter [heic|avif|jpeg|png] path/to/input_file.heic /path/to/output_file.png ``` *Note: It will detect output file format automatically based on the extension* App ships with 3 binary file in the bin directory. Choose by your platform: - heif-converter-linux - heif-converter-macos - heif-converter-windows.exe Contributions ------------- [](#contributions) We warmly welcome all contributions to the heif-converter-image project! This project is completely open source and relies on contributions from the community to expand its reach, improve its functionality, and fix any existing issues. #### How to Contribute [](#how-to-contribute) If you are interested in contributing to the heif-converter-image project, you are free to submit Pull Requests and Issues. Your contributions can range from bug fixes, feature enhancements, adding documentation, to writing test cases. Before submitting a Pull Request, please ensure that you have tested your changes thoroughly and that all tests pass. In your Pull Requests, be as detailed as possible in your commit messages and comments to help the maintainers understand your changes. For Issues, provide as much detail as you can about the problem, including steps to reproduce it, your operating system and version, etc. Building for Different Platforms Currently, heif-converter-image is shipped with executables for Windows, Linux, and macOS Intel-based architectures. However, we understand the growing demand and necessity for supporting a broader range of platforms. We're particularly interested in expanding support for Linux ARM64 and macOS M1 architectures. If you have experience in building for these platforms or have these systems for testing, your contributions would be greatly appreciated. Remember, open source projects thrive on the collaboration and contributions from developers like you. Together, we can make heif-converter-image even better. Let's build something amazing together! ### Development [](#development) - build test bin `go build -o bin/heif-converter` Support ------- [](#support) Support Our Work? 🌟 You can help us keep the code flowing by making a small donation. Every bit of support goes a long way in maintaining and improving our open-source contributions. Click the button below to contribute. Thank you for your generosity! [![](https://github.com/MaestroError/resources/raw/maestro/buymeamilk/green-2.png)](https://www.buymeacoffee.com/maestroerror) Or use QR code: [![](https://github.com/MaestroError/resources/raw/maestro/buymeamilk/qr-code.png)](https://www.buymeacoffee.com/maestroerror) ### Health Score 29 — LowBetter than 59% of packages Maintenance13 Infrequent updates — may be unmaintained Popularity44 Moderate usage in the ecosystem Community11 Small or concentrated contributor base Maturity35 Early-stage or recently created project Bus Factor1 Top contributor holds 100% of commits — single point of failure How is this calculated?**Maintenance (25%)** — Last commit recency, latest release date, and issue-to-star ratio. Uses a 2-year decay window. **Popularity (30%)** — Total and monthly downloads, GitHub stars, and forks. Logarithmic scaling prevents top-heavy scores. **Community (15%)** — Contributors, dependents, forks, watchers, and maintainers. Measures real ecosystem engagement. **Maturity (30%)** — Project age, version count, PHP version support, and release stability. ### Release Activity Cadence Every ~19 days Total 2 Last Release 1060d ago ### Community Maintainers ![](https://www.gravatar.com/avatar/9b3015d66e88ffcecb330b381383fc9e343dbe1deffc3b62cff21d569901f17e?d=identicon)[maestroerror](/maintainers/maestroerror) --- Top Contributors [![MaestroError](https://avatars.githubusercontent.com/u/46760939?v=4)](https://github.com/MaestroError "MaestroError (41 commits)") --- Tags clidockergolangheifheif-to-jpeglibheif ### Embed Badge ![Health badge](/badges/maestroerror-heif-converter/health.svg) ``` [![Health](https://phpackages.com/badges/maestroerror-heif-converter/health.svg)](https://phpackages.com/packages/maestroerror-heif-converter) ``` ### Alternatives [wp-cli/wp-cli WP-CLI framework 5.1k17.2M320](/packages/wp-cli-wp-cli)[consolidation/annotated-command Initialize Symfony Console commands from annotated command class methods. 22569.8M19](/packages/consolidation-annotated-command)[seld/cli-prompt Allows you to prompt for user input on the command line, and optionally hide the characters they type 24725.8M17](/packages/seld-cli-prompt)[illuminate/console The Illuminate Console package. 12944.1M5.1k](/packages/illuminate-console)[php-tui/php-tui Comprehensive TUI library heavily influenced by Ratatui 589747.0k6](/packages/php-tui-php-tui)[codedungeon/php-cli-colors Liven up you PHP Console Apps with standard colors 10210.1M26](/packages/codedungeon-php-cli-colors) PHPackages © 2026 [Directory](/)[Categories](/categories)[Trending](/trending)[Changelog](/changelog)[Analyze](/analyze)