saschiwy / HeicConverter

A very simple command line tool to convert heic files to jpg
MIT License
146 stars 21 forks source link

HeicConverter

Introduction

A very simple command line tool to convert *.heic files to jpg. Since the available programs for windows are either paid or not working for me, I decided to make a simple python script to help convert these files.

Features

Quick Usage

  1. Copy the prepared exe to the folder with heic files for convert and double click it.
  2. Use Command line and append the path of interest:
./heicConverter.exe path/to/pictures

Command Line

Start the script (or exe) from command line for additional options:

heicConverter.exe [-h] [-r] [-o] [--not-recursive] [--skip-prompt] path

Convert HEIC files to JPEG

positional arguments:
  path             the path to the file or directory to convert

options:
  -h, --help       show this help message and exit
  -r, --remove     Remove converted HEIC Files
  -o, --overwrite  Overwrite existing JPEG files
  --not-recursive  Do not search subdirectories
  --skip-prompt    Skip the prompt at the end

GUI

Also a GUI Version is available. Just start HeicConverterGui.exe.

GUI

Installation

Windows

Download the latest release from the Release Page and extract it somewhere on your machine.

Linux / Mac

Download the repo, install the dependencies and run the script.

Development Dependencies

Install the python package dependencies with:

pip install -r requirements.txt

Create your own executable

Install pyinstaller with:

pip install pyinstaller

Install the dependencies, navigate with a console to the source dir and run the following commands:

python -m PyInstaller --onefile --console heicConverter.py
python -m PyInstaller --onefile --windowed heicConverterGui.py

Remarks

This software was mainly created by people at StackOverflow: https://stackoverflow.com/questions/54395735/how-to-work-with-heic-image-file-types-in-python

Example

Example

Donate