Giter Club home page Giter Club logo

heif-convert's Introduction

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

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

Python repository

The easiest way to get heif-convert is through the pypi.org repository. Install it by running the following command:

pip install heif-convert

Building from source

To install heif-convert from source, clone this repository and run pip install . as follows:

git clone https://github.com/NeverMendel/heif-convert.git
cd heif-convert
pip install .

Docker image

To pull heif-convert Docker image, run:

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:

heif-convert input.heic -f jpg

Convert all HEIF images in the current folder to JPG images:

heif-convert *.heic -f jpg

Docker image

Convert an HEIF image to PNG using the Docker image:

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:

Supported operating systems

heif-convert works on Linux, Mac OS and Windows systems. For further information refer to the pillow_heif repository.

License

MIT License

heif-convert's People

Contributors

dependabot[bot] avatar kohlerdominik avatar nevermendel avatar

Stargazers

 avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar

Watchers

 avatar

heif-convert's Issues

Migrate PyPI packaging format to Wheels

What?

Since January 1, 2023, we noticed upload(s) of .egg/bdist_egg distribution file(s) to PyPI for heif-convert.

PyPI is in the process of deprecating bdist_egg distribution file uploads, and will not accept them beginning August 1, 2023.

What should I do?

Update your release tooling to cease upload of .egg/bdist_egg distribution files. If you are not already, and require binary releases, update your release tooling to upload .whl/bdist_wheel distribution files instead.

Read more about Wheels vs Egg distribution files.

Recommend Projects

  • React photo React

    A declarative, efficient, and flexible JavaScript library for building user interfaces.

  • Vue.js photo Vue.js

    ๐Ÿ–– Vue.js is a progressive, incrementally-adoptable JavaScript framework for building UI on the web.

  • Typescript photo Typescript

    TypeScript is a superset of JavaScript that compiles to clean JavaScript output.

  • TensorFlow photo TensorFlow

    An Open Source Machine Learning Framework for Everyone

  • Django photo Django

    The Web framework for perfectionists with deadlines.

  • D3 photo D3

    Bring data to life with SVG, Canvas and HTML. ๐Ÿ“Š๐Ÿ“ˆ๐ŸŽ‰

Recommend Topics

  • javascript

    JavaScript (JS) is a lightweight interpreted programming language with first-class functions.

  • web

    Some thing interesting about web. New door for the world.

  • server

    A server is a program made to process requests and deliver data to clients.

  • Machine learning

    Machine learning is a way of modeling and interpreting data that allows a piece of software to respond intelligently.

  • Game

    Some thing interesting about game, make everyone happy.

Recommend Org

  • Facebook photo Facebook

    We are working to build community through open source technology. NB: members must have two-factor auth.

  • Microsoft photo Microsoft

    Open source projects and samples from Microsoft.

  • Google photo Google

    Google โค๏ธ Open Source for everyone.

  • D3 photo D3

    Data-Driven Documents codes.