raw-image-converter 1.1.3
Batch image convertions
License: MIT
Requires Python: <4.0,>=3.9
Keywords: cli, converter, raw, images

# Python Image Converter
[![PyPI version](https://badge.fury.io/py/raw-image-converter.svg)](https://pypi.org/project/raw-image-converter/)
[![All Contributors](https://img.shields.io/github/all-contributors/achimoraites/Python-Image-Converter?color=ee8449&style=flat-square)](#contributors)

The Python Image Converter is a user-friendly CLI tool designed for hassle-free batch conversion of image files.

Once upon a time, converting multiple images came with either slow, tedious processes or even paid tools. 
Not anymore!

This open-source image converter can empower anyone, from busy image professionals to individuals passionate about photography.

## Features
- **Bulk Conversion:** Say goodbye to the tedious one-by-one image conversion. Convert hundreds of images at once.
- **Supported File Types:** DNG, CR2, CRW, NEF, PEF, ERF, ORF, PPM, MOS, MRF, MRW, SRW, PSD, TIF, and more.
- **Fast:** Multi-core support.
- **Customizable Output:** Specify your converted images' output directory, resolution, and format

## Install

### Using pip (recommended)
```bash
$ pip3 install raw_image_converter
```

### Running it from the repo 

```bash
 git clone https://github.com/achimoraites/Python-Image-Converter.git [my-app-name]
 cd [my-app-name]

poetry install
poetry shell

 python -m raw_image_converter --s <Enter-Path-Of-Directory>
```
## Example usage

### Arguments
- `-s, --src` (required): set the path to the directory you want to convert (source)! 
- `-t, --tgt`: where to store the converted images (target); by default, they are stored in the "converted" folder. 
- `-d, --delete-source-directory`: removes the directory with the original images (source).
- `-r, --resolution`: allows to set the converted image resolutions; you can use numbers or percentages: e.g., 75% -> width and height are 75% of the original size, 1000,1500 -> width to 1000px and the height to 1500px
- `-e, --ext`: specify the output image format for the converted images; by default, it is JPG. Valid options are:
    - `.jpg`
    - `.png`

```
 # simple usage
 raw_image_converter -s <Enter-Path-Of-Directory>

 # set a custom target image format
 raw_image_converter --s <Enter-Path-Of-Directory> --ext '.png'

 # Advanced usage 1
 raw_image_converter -s images -t converted/png -r 25% -e .png -d

 # Set custom resolution 1
 raw_image_converter -s images -t converted/jpg -r 1024,768

 # Set custom resolution 2
 raw_image_converter -s images -t converted/jpg -r 50%,33%
```


And you are done! 

## ScreenShot
<img src='https://raw.githubusercontent.com/achimoraites/Python-Image-Converter/master/sample.png' alt='Python Image Converter'>


## Contributors

<!-- ALL-CONTRIBUTORS-LIST:START - Do not remove or modify this section -->
<!-- prettier-ignore-start -->
<!-- markdownlint-disable -->
<table>
  <tbody>
    <tr>
      <td align="center" valign="top" width="14.28%"><a href="https://github.com/23198"><img src="https://avatars.githubusercontent.com/u/31165700?v=4?s=100" width="100px;" alt="23198"/><br /><sub><b>23198</b></sub></a><br /><a href="https://github.com/achimoraites/Python-Image-Converter/commits?author=23198" title="Code">💻</a></td>
      <td align="center" valign="top" width="14.28%"><a href="https://achimoraites.io/"><img src="https://avatars.githubusercontent.com/u/4193340?v=4?s=100" width="100px;" alt="Achilles Moraites"/><br /><sub><b>Achilles Moraites</b></sub></a><br /><a href="#ideas-achimoraites" title="Ideas, Planning, & Feedback">🤔</a> <a href="https://github.com/achimoraites/Python-Image-Converter/commits?author=achimoraites" title="Code">💻</a></td>
      <td align="center" valign="top" width="14.28%"><a href="https://github.com/papsphilip"><img src="https://avatars.githubusercontent.com/u/27963785?v=4?s=100" width="100px;" alt="Filippos Pappas"/><br /><sub><b>Filippos Pappas</b></sub></a><br /><a href="#ideas-papsphilip" title="Ideas, Planning, & Feedback">🤔</a></td>
      <td align="center" valign="top" width="14.28%"><a href="https://github.com/AgentSchmisch"><img src="https://avatars.githubusercontent.com/u/78489341?v=4?s=100" width="100px;" alt="Florian Schmid"/><br /><sub><b>Florian Schmid</b></sub></a><br /><a href="https://github.com/achimoraites/Python-Image-Converter/commits?author=AgentSchmisch" title="Code">💻</a> <a href="#ideas-AgentSchmisch" title="Ideas, Planning, & Feedback">🤔</a></td>
      <td align="center" valign="top" width="14.28%"><a href="https://blog.disasm.me/"><img src="https://avatars.githubusercontent.com/u/25303578?v=4?s=100" width="100px;" alt="Rakovskij Stanislav"/><br /><sub><b>Rakovskij Stanislav</b></sub></a><br /><a href="https://github.com/achimoraites/Python-Image-Converter/commits?author=rakovskij-stanislav" title="Code">💻</a> <a href="#ideas-rakovskij-stanislav" title="Ideas, Planning, & Feedback">🤔</a></td>
      <td align="center" valign="top" width="14.28%"><a href="https://github.com/ShadoWxShinigamI"><img src="https://avatars.githubusercontent.com/u/116374738?v=4?s=100" width="100px;" alt="ShadoWxShinigamI"/><br /><sub><b>ShadoWxShinigamI</b></sub></a><br /><a href="#ideas-ShadoWxShinigamI" title="Ideas, Planning, & Feedback">🤔</a></td>
      <td align="center" valign="top" width="14.28%"><a href="https://github.com/felixjchen"><img src="https://avatars.githubusercontent.com/u/31393977?v=4?s=100" width="100px;" alt="felixjchen"/><br /><sub><b>felixjchen</b></sub></a><br /><a href="#ideas-felixjchen" title="Ideas, Planning, & Feedback">🤔</a></td>
    </tr>
  </tbody>
</table>

<!-- markdownlint-restore -->
<!-- prettier-ignore-end -->

<!-- ALL-CONTRIBUTORS-LIST:END -->