# Python Image Converter
[](https://pypi.org/project/raw-image-converter/)
[](#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 -->
Raw data
{
"_id": null,
"home_page": "https://github.com/achimoraites/Python-Image-Converter",
"name": "raw-image-converter",
"maintainer": null,
"docs_url": null,
"requires_python": "<4.0,>=3.9",
"maintainer_email": null,
"keywords": "cli, converter, raw, images",
"author": "Achilles Moraites",
"author_email": "achimoraites@yahoo.gr",
"download_url": "https://files.pythonhosted.org/packages/ba/df/3f15051dcbd95cb7b4eaa61299d7cd6b51981a8ee57cdebd5e71f6976d9c/raw_image_converter-1.1.3.tar.gz",
"platform": null,
"description": "# Python Image Converter\n[](https://pypi.org/project/raw-image-converter/)\n[](#contributors)\n\nThe Python Image Converter is a user-friendly CLI tool designed for hassle-free batch conversion of image files.\n\nOnce upon a time, converting multiple images came with either slow, tedious processes or even paid tools. \nNot anymore!\n\nThis open-source image converter can empower anyone, from busy image professionals to individuals passionate about photography.\n\n## Features\n- **Bulk Conversion:** Say goodbye to the tedious one-by-one image conversion. Convert hundreds of images at once.\n- **Supported File Types:** DNG, CR2, CRW, NEF, PEF, ERF, ORF, PPM, MOS, MRF, MRW, SRW, PSD, TIF, and more.\n- **Fast:** Multi-core support.\n- **Customizable Output:** Specify your converted images' output directory, resolution, and format\n\n## Install\n\n### Using pip (recommended)\n```bash\n$ pip3 install raw_image_converter\n```\n\n### Running it from the repo \n\n```bash\n git clone https://github.com/achimoraites/Python-Image-Converter.git [my-app-name]\n cd [my-app-name]\n\npoetry install\npoetry shell\n\n python -m raw_image_converter --s <Enter-Path-Of-Directory>\n```\n## Example usage\n\n### Arguments\n- `-s, --src` (required): set the path to the directory you want to convert (source)! \n- `-t, --tgt`: where to store the converted images (target); by default, they are stored in the \"converted\" folder. \n- `-d, --delete-source-directory`: removes the directory with the original images (source).\n- `-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\n- `-e, --ext`: specify the output image format for the converted images; by default, it is JPG. Valid options are:\n - `.jpg`\n - `.png`\n\n```\n # simple usage\n raw_image_converter -s <Enter-Path-Of-Directory>\n\n # set a custom target image format\n raw_image_converter --s <Enter-Path-Of-Directory> --ext '.png'\n\n # Advanced usage 1\n raw_image_converter -s images -t converted/png -r 25% -e .png -d\n\n # Set custom resolution 1\n raw_image_converter -s images -t converted/jpg -r 1024,768\n\n # Set custom resolution 2\n raw_image_converter -s images -t converted/jpg -r 50%,33%\n```\n\n\nAnd you are done! \n\n## ScreenShot\n<img src='https://raw.githubusercontent.com/achimoraites/Python-Image-Converter/master/sample.png' alt='Python Image Converter'>\n\n\n## Contributors\n\n<!-- ALL-CONTRIBUTORS-LIST:START - Do not remove or modify this section -->\n<!-- prettier-ignore-start -->\n<!-- markdownlint-disable -->\n<table>\n <tbody>\n <tr>\n <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\">\ud83d\udcbb</a></td>\n <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\">\ud83e\udd14</a> <a href=\"https://github.com/achimoraites/Python-Image-Converter/commits?author=achimoraites\" title=\"Code\">\ud83d\udcbb</a></td>\n <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\">\ud83e\udd14</a></td>\n <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\">\ud83d\udcbb</a> <a href=\"#ideas-AgentSchmisch\" title=\"Ideas, Planning, & Feedback\">\ud83e\udd14</a></td>\n <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\">\ud83d\udcbb</a> <a href=\"#ideas-rakovskij-stanislav\" title=\"Ideas, Planning, & Feedback\">\ud83e\udd14</a></td>\n <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\">\ud83e\udd14</a></td>\n <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\">\ud83e\udd14</a></td>\n </tr>\n </tbody>\n</table>\n\n<!-- markdownlint-restore -->\n<!-- prettier-ignore-end -->\n\n<!-- ALL-CONTRIBUTORS-LIST:END -->\n",
"bugtrack_url": null,
"license": "MIT",
"summary": "Batch image convertions",
"version": "1.1.3",
"project_urls": {
"Homepage": "https://github.com/achimoraites/Python-Image-Converter",
"Repository": "https://github.com/achimoraites/Python-Image-Converter"
},
"split_keywords": [
"cli",
" converter",
" raw",
" images"
],
"urls": [
{
"comment_text": "",
"digests": {
"blake2b_256": "9af319b72733d55b238fca68c22506968056a3efb5490f3b889a2cc35a197443",
"md5": "d32fc3ba8b54cbaaed0623367715ffde",
"sha256": "f7502ec1b5190fdefc0391286ef3e621718ae08437a2080f98091e83922a93ca"
},
"downloads": -1,
"filename": "raw_image_converter-1.1.3-py3-none-any.whl",
"has_sig": false,
"md5_digest": "d32fc3ba8b54cbaaed0623367715ffde",
"packagetype": "bdist_wheel",
"python_version": "py3",
"requires_python": "<4.0,>=3.9",
"size": 7273,
"upload_time": "2024-04-30T21:44:39",
"upload_time_iso_8601": "2024-04-30T21:44:39.853395Z",
"url": "https://files.pythonhosted.org/packages/9a/f3/19b72733d55b238fca68c22506968056a3efb5490f3b889a2cc35a197443/raw_image_converter-1.1.3-py3-none-any.whl",
"yanked": false,
"yanked_reason": null
},
{
"comment_text": "",
"digests": {
"blake2b_256": "badf3f15051dcbd95cb7b4eaa61299d7cd6b51981a8ee57cdebd5e71f6976d9c",
"md5": "6c7e092aa890ffe359c3c2cce9cbf495",
"sha256": "64755ed88db2d3bca3c63da06f325ef156fbdf69cb0e88df7bcada631622a52e"
},
"downloads": -1,
"filename": "raw_image_converter-1.1.3.tar.gz",
"has_sig": false,
"md5_digest": "6c7e092aa890ffe359c3c2cce9cbf495",
"packagetype": "sdist",
"python_version": "source",
"requires_python": "<4.0,>=3.9",
"size": 5951,
"upload_time": "2024-04-30T21:44:41",
"upload_time_iso_8601": "2024-04-30T21:44:41.607725Z",
"url": "https://files.pythonhosted.org/packages/ba/df/3f15051dcbd95cb7b4eaa61299d7cd6b51981a8ee57cdebd5e71f6976d9c/raw_image_converter-1.1.3.tar.gz",
"yanked": false,
"yanked_reason": null
}
],
"upload_time": "2024-04-30 21:44:41",
"github": true,
"gitlab": false,
"bitbucket": false,
"codeberg": false,
"github_user": "achimoraites",
"github_project": "Python-Image-Converter",
"travis_ci": false,
"coveralls": false,
"github_actions": true,
"lcname": "raw-image-converter"
}
JSON
