# Rexize - Bulk Resize and Convert Images tool
Welcome to the Rexize CLI Tool, an open-source command-line interface tool designed for bulk resizing and converting image files. This tool efficiently processes images in a directory recursively, outputting them to a specified directory with your chosen dimensions and formats. It is built with flexibility and efficiency in mind, to cater to a wide range of use cases and users.
## Features
- **Bulk Resizing**: Resize multiple images in a batch to your desired dimensions.
- **Format Conversion**: Convert images into different formats (e.g., JPEG, PNG) in one go.
- **Recursive Directory Processing**: Process images in a directory and its subdirectories.
- **Custom Output Directory**: Specify a different directory to output the processed images.
## About
This CLI tool for bulk resizing and converting image files has wide-ranging applications, benefiting users in web development, digital marketing, photography, and data science. It streamlines workflows, ensures consistency in image quality and size, and facilitates efficient storage and transfer.
## Potential Use Cases
This tool is versatile and can be beneficial across various fields. Its potential use cases and benefits span several domains, including but not limited to:
1. **Web Development and Design**: Optimize images for web usage, ensuring fast loading times and responsiveness without compromising quality. Bulk prepare thumbnails, hero images, and other assets for websites.
2. **Digital Marketing**: Prepare images for different social media platforms, email campaigns, and online ads with ease.
3. **Photography**: Resize and convert images for client delivery, portfolio display, or contest submissions efficiently.
4. **Data Science and Machine Learning**: Automate the preprocessing of images for computer vision projects.
5. **Archiving and Digital Libraries**: Standardize image sizes and formats for digital archiving purposes.
6. **Personal Use**: Manage personal image collections, optimizing for storage or preparing for social media and personal websites.
## Benefits
- **Efficiency and Time-Saving**: Automates a task that would be incredibly time-consuming if done manually, especially for large image collections.
- **Quality and Consistency**: Ensures that all images meet set criteria for size and format, maintaining a high standard across a project or campaign.
- **Open-Source Collaboration**: Being open-sourced, it encourages collaboration and contributions from other developers, leading to new features, bug fixes, and improvements.
- **Customization and Flexibility**: Users can adapt the tool to fit their specific needs, whether that's integrating it into larger workflows or customizing it for unique project requirements.
- **Resource Optimization**: Helps in optimizing web pages by reducing load times and improving user experience, which can contribute to better SEO rankings and user retention.
## Getting Started
To get started with Rexize, please ensure you have the Prerequisites and follow the installation instructions below:
### Prerequisites
- Python 3.11 or higher
- Pip package manager
- Basic knowledge of the command line interface for now. A GUI wrapper is in the works.
### Installation
```bash
pip install rexize
```
## Usage
```
rexize [options] input_folder output_folder
Bulk resize and convert images from a folder recursively.
positional arguments:
input_folder Input folder containing images
output_folder Output folder for resized images
options:
-h, --help show this help message and exit
-W WIDTH, --width WIDTH
Width to resize the image. Suffix with for percentage
-H HEIGHT, --height HEIGHT
Height to resize the image. Suffix with for percentage
-M MAX_SIZE, --max-size MAX_SIZE
Maximum size in pixels for the image. Resize if larger than this size
-f FORMAT, --format FORMAT
Format of the output image: JPEG, PNG, WEBP, GIF, TIFF, BMP
--rgb Downscale RGBA images to RGB
--grayscale Downscale images to Grayscale
-q, --quiet Suppress all output messages, except errors
--verbose Verbose output for debugging
```
## Project URLs
- **GitHub Repository**: https://github.com/joelee/rexize
- **PyPI Package**: https://pypi.org/project/rexize/
## How to Contribute
We welcome contributions from the community, whether it's adding new features, fixing bugs, or improving documentation. If you have a feature request or have identified an issue, please open an issue on GitHub. We also encourage you to fork the repository and submit pull requests with your improvements.
## Features TO DO
- [ ] User documentation
- [ ] Bulk renaming image files
- [ ] Rotation and Cropping support
- [ ] Custom filters
- [ ] A new GUI Wrapper
- [ ] Increase Test Coverage to above 90%
Raw data
{
"_id": null,
"home_page": "https://github.com/joelee/rexize",
"name": "rexize",
"maintainer": null,
"docs_url": null,
"requires_python": "<4.0,>=3.11",
"maintainer_email": null,
"keywords": "cli, image, resize, convert, bulk",
"author": "Joseph Lee",
"author_email": "joel@joeworks.com",
"download_url": "https://files.pythonhosted.org/packages/34/7a/1109bf6dad33d733b5f65c36e12b9ebeeb17e33d56dc7d5a535f6334283b/rexize-0.2.3.tar.gz",
"platform": null,
"description": "# Rexize - Bulk Resize and Convert Images tool\n\nWelcome to the Rexize CLI Tool, an open-source command-line interface tool designed for bulk resizing and converting image files. This tool efficiently processes images in a directory recursively, outputting them to a specified directory with your chosen dimensions and formats. It is built with flexibility and efficiency in mind, to cater to a wide range of use cases and users.\n\n\n## Features\n\n- **Bulk Resizing**: Resize multiple images in a batch to your desired dimensions.\n- **Format Conversion**: Convert images into different formats (e.g., JPEG, PNG) in one go.\n- **Recursive Directory Processing**: Process images in a directory and its subdirectories.\n- **Custom Output Directory**: Specify a different directory to output the processed images.\n\n\n## About\nThis CLI tool for bulk resizing and converting image files has wide-ranging applications, benefiting users in web development, digital marketing, photography, and data science. It streamlines workflows, ensures consistency in image quality and size, and facilitates efficient storage and transfer.\n\n\n## Potential Use Cases\n\nThis tool is versatile and can be beneficial across various fields. Its potential use cases and benefits span several domains, including but not limited to:\n\n1. **Web Development and Design**: Optimize images for web usage, ensuring fast loading times and responsiveness without compromising quality. Bulk prepare thumbnails, hero images, and other assets for websites.\n2. **Digital Marketing**: Prepare images for different social media platforms, email campaigns, and online ads with ease.\n3. **Photography**: Resize and convert images for client delivery, portfolio display, or contest submissions efficiently.\n4. **Data Science and Machine Learning**: Automate the preprocessing of images for computer vision projects.\n5. **Archiving and Digital Libraries**: Standardize image sizes and formats for digital archiving purposes.\n6. **Personal Use**: Manage personal image collections, optimizing for storage or preparing for social media and personal websites.\n\n\n## Benefits\n\n- **Efficiency and Time-Saving**: Automates a task that would be incredibly time-consuming if done manually, especially for large image collections.\n- **Quality and Consistency**: Ensures that all images meet set criteria for size and format, maintaining a high standard across a project or campaign.\n- **Open-Source Collaboration**: Being open-sourced, it encourages collaboration and contributions from other developers, leading to new features, bug fixes, and improvements.\n- **Customization and Flexibility**: Users can adapt the tool to fit their specific needs, whether that's integrating it into larger workflows or customizing it for unique project requirements.\n- **Resource Optimization**: Helps in optimizing web pages by reducing load times and improving user experience, which can contribute to better SEO rankings and user retention.\n\n\n## Getting Started\nTo get started with Rexize, please ensure you have the Prerequisites and follow the installation instructions below:\n\n### Prerequisites\n- Python 3.11 or higher\n- Pip package manager\n- Basic knowledge of the command line interface for now. A GUI wrapper is in the works.\n\n### Installation\n```bash\npip install rexize\n```\n\n## Usage\n```\nrexize [options] input_folder output_folder\n\n\n Bulk resize and convert images from a folder recursively.\n\n\n positional arguments:\n input_folder Input folder containing images\n output_folder Output folder for resized images\n\n options:\n -h, --help show this help message and exit\n -W WIDTH, --width WIDTH\n Width to resize the image. Suffix with for percentage\n -H HEIGHT, --height HEIGHT\n Height to resize the image. Suffix with for percentage\n -M MAX_SIZE, --max-size MAX_SIZE\n Maximum size in pixels for the image. Resize if larger than this size\n -f FORMAT, --format FORMAT\n Format of the output image: JPEG, PNG, WEBP, GIF, TIFF, BMP\n --rgb Downscale RGBA images to RGB\n --grayscale Downscale images to Grayscale\n -q, --quiet Suppress all output messages, except errors\n --verbose Verbose output for debugging\n\n```\n\n\n## Project URLs\n- **GitHub Repository**: https://github.com/joelee/rexize\n- **PyPI Package**: https://pypi.org/project/rexize/\n\n\n## How to Contribute\n\nWe welcome contributions from the community, whether it's adding new features, fixing bugs, or improving documentation. If you have a feature request or have identified an issue, please open an issue on GitHub. We also encourage you to fork the repository and submit pull requests with your improvements.\n\n\n## Features TO DO\n- [ ] User documentation\n- [ ] Bulk renaming image files\n- [ ] Rotation and Cropping support\n- [ ] Custom filters\n- [ ] A new GUI Wrapper\n- [ ] Increase Test Coverage to above 90%\n",
"bugtrack_url": null,
"license": "MIT",
"summary": "CLI to bulk resize and convert images recursively",
"version": "0.2.3",
"project_urls": {
"Homepage": "https://github.com/joelee/rexize",
"Repository": "https://github.com/joelee/rexize"
},
"split_keywords": [
"cli",
" image",
" resize",
" convert",
" bulk"
],
"urls": [
{
"comment_text": "",
"digests": {
"blake2b_256": "376eed5365d75a0d2b469cc17970c6f5f95302e1860b082b3a7e449798707c6d",
"md5": "917bcddb6a97b157084f97d69a5dad71",
"sha256": "07cc7036c12a6d803e03bc8e75a5fb0f3fc4a128dfc1b45ae8719d0ec069c671"
},
"downloads": -1,
"filename": "rexize-0.2.3-py3-none-any.whl",
"has_sig": false,
"md5_digest": "917bcddb6a97b157084f97d69a5dad71",
"packagetype": "bdist_wheel",
"python_version": "py3",
"requires_python": "<4.0,>=3.11",
"size": 13949,
"upload_time": "2024-03-29T04:12:05",
"upload_time_iso_8601": "2024-03-29T04:12:05.079924Z",
"url": "https://files.pythonhosted.org/packages/37/6e/ed5365d75a0d2b469cc17970c6f5f95302e1860b082b3a7e449798707c6d/rexize-0.2.3-py3-none-any.whl",
"yanked": false,
"yanked_reason": null
},
{
"comment_text": "",
"digests": {
"blake2b_256": "347a1109bf6dad33d733b5f65c36e12b9ebeeb17e33d56dc7d5a535f6334283b",
"md5": "d6ae3acc515cb353e4ce7648e176cd5f",
"sha256": "c03f84075e9a2ee0d743f5046121fe2ac60b224c19e3450b098e37f15fead6e2"
},
"downloads": -1,
"filename": "rexize-0.2.3.tar.gz",
"has_sig": false,
"md5_digest": "d6ae3acc515cb353e4ce7648e176cd5f",
"packagetype": "sdist",
"python_version": "source",
"requires_python": "<4.0,>=3.11",
"size": 10165,
"upload_time": "2024-03-29T04:12:06",
"upload_time_iso_8601": "2024-03-29T04:12:06.837535Z",
"url": "https://files.pythonhosted.org/packages/34/7a/1109bf6dad33d733b5f65c36e12b9ebeeb17e33d56dc7d5a535f6334283b/rexize-0.2.3.tar.gz",
"yanked": false,
"yanked_reason": null
}
],
"upload_time": "2024-03-29 04:12:06",
"github": true,
"gitlab": false,
"bitbucket": false,
"codeberg": false,
"github_user": "joelee",
"github_project": "rexize",
"travis_ci": false,
"coveralls": false,
"github_actions": true,
"lcname": "rexize"
}
JSON
