Ecosyste.ms: Awesome
An open API service indexing awesome lists of open source software.
https://github.com/edoardotosin/batch-image-converter
Streamline your image editing process with this Python script, capable of converting large batches of images to desired formats and specifications, including DPI, resolution, and color space.
https://github.com/edoardotosin/batch-image-converter
conversion converter image-processing jpeg pillow png python python3
Last synced: 12 days ago
JSON representation
Streamline your image editing process with this Python script, capable of converting large batches of images to desired formats and specifications, including DPI, resolution, and color space.
- Host: GitHub
- URL: https://github.com/edoardotosin/batch-image-converter
- Owner: EdoardoTosin
- License: gpl-3.0
- Created: 2022-06-10T10:39:25.000Z (over 2 years ago)
- Default Branch: main
- Last Pushed: 2024-07-12T10:30:17.000Z (7 months ago)
- Last Synced: 2024-07-12T12:00:36.385Z (7 months ago)
- Topics: conversion, converter, image-processing, jpeg, pillow, png, python, python3
- Language: Python
- Homepage: http://edoardotosin.com/Batch-Image-Converter/
- Size: 1.61 MB
- Stars: 2
- Watchers: 1
- Forks: 1
- Open Issues: 1
-
Metadata Files:
- Readme: README.md
- Contributing: CONTRIBUTING.md
- License: LICENSE
- Code of conduct: CODE_OF_CONDUCT.md
- Security: SECURITY.md
Awesome Lists containing this project
README
Batch Image Converter
## Summary
Python script that enables users to convert images to a specific dpi, maximum long side resolution, and RGB color space. It supports various file types and provides a user-friendly CLI for easy usage. Additionally, it offers precompiled binaries for Linux, Windows, and Mac platforms, allowing users to run the script without installing Python or any dependencies.
## Features
- Convert images to a specific dpi and maximum long side resolution (Default: 72dpi, 1000px).
- Convert images to RGB color space (Important: ICC colour profiles are not used for this conversion so switching between different formats may result in incorrect colours).
- Downscale images using different filters.
- Compress the palette by eliminating unused colors.
- Alert user upon completion of conversion.
- Wait for user keypress upon completion of conversion.
## Method 1: Download release binary
There are precompiled binaries for Linux, Windows, and Mac. These binary files allow you to run the script without installing Python or any dependencies. You can download these binaries from the [Releases](https://github.com/EdoardoTosin/Batch-Image-Converter/releases/latest) page. After downloading, simply run the binary file to start using the script.
## Method 2: Build release binary
If you wish to manually build the binaries, the repository contains scripts to do so for both Windows and Linux platforms.
For Windows, from the `Batch-Image-Converter` directory run `buildWin.ps1` PowerShell script as followed:
```powershell
git clone https://github.com/EdoardoTosin/Batch-Image-Converter.git
cd Batch-Image-Converter
.\tools\buildWin.ps1
```
For Linux, from the `Batch-Image-Converter` directory run `buildLinux.ps1` bash script as followed:
```bash
git clone https://github.com/EdoardoTosin/Batch-Image-Converter.git
cd Batch-Image-Converter
./tools/buildLinux.sh
```
These scripts will automatically build the binaries for the corresponding platform.
## Method 3: Run with Python3
First, clone the repository:
```bash
git clone https://github.com/EdoardoTosin/Batch-Image-Converter.git
```
Next, navigate into the cloned repository:
```bash
cd Batch-Image-Converter
```
Afterwards, install the required Python packages using the `requirements.txt` file:
```bash
pip3 install -r requirements.txt
```
Once you have installed the required packages and are ready to run the script, you need to move the `main.py` file from the `src` directory into the folder where you want to convert images.
On Linux, use the `mv` command:
```bash
mv src/main.py /path/to/your/folder
```
On Windows, use the `move` command:
```powershell
Move-Item -Path "src\main.py" -Destination "\path\to\your\folder"
```
After moving the `main.py` file, navigate to the folder where you moved the file and run the script:
On Linux:
```bash
cd /path/to/your/folder
python3 main.py --help
```
On Windows:
```powershell
cd \path\to\your\folder
python main.py --help
```
## Usage
The script takes several command line arguments:
- `-p` or `--path`: Specify the directory where the images are located. Defaults to the current directory.
- `-d` or `--dpi`: Specify the pixel density in pixels per inch (dpi). Must be in the range 1-1000. Defaults to 72.
- `-s` or `--size`: Specify the maximum resolution of the image (long side) in pixels. For downscaling only. Must be in the range 1-10000. Defaults to 1000.
- `-f` or `--filter`: Specify the type of filter used for downscaling. Must be an integer in the range 0-5. Defaults to 0 (Nearest). ([Filters comparison table](https://pillow.readthedocs.io/en/stable/handbook/concepts.html#filters-comparison-table))
- `--colorspace` or `--cs`: Convert all images to RGB color space.
- `-q` or `--quality`: Specify the quality of output images. Must be in the range 1-100. Values above 95 should be avoided. Defaults to 80.
- `-m` or `--max-image-mpixels`: Specify the maximum images resolution allowed in Megapixel. Defaults to 0 (None).
- `--optimize`: Attempt to compress the palette by eliminating unused colors.
- `--alert`: Play alert sound when finished the conversion.
- `--wait`: Wait for user keypress (Enter) when finished the conversion.
## Security Policy
For more details see the [SECURITY](https://github.com/EdoardoTosin/Batch-Image-Converter/blob/main/SECURITY.md) file.
## Contributing
See [CONTRIBUTING.md](https://github.com/EdoardoTosin/Batch-Image-Converter/tree/main/CONTRIBUTING.md).
## License
This software is released under the terms of the GNU General Public License v3.0. See the [LICENSE](https://github.com/EdoardoTosin/Batch-Image-Converter/tree/main/LICENSE) file for further information.