https://github.com/joaopalmeiro/itils
A Python CLI for transforming images.
https://github.com/joaopalmeiro/itils
cli image image-processing imagemagick python
Last synced: about 1 month ago
JSON representation
A Python CLI for transforming images.
- Host: GitHub
- URL: https://github.com/joaopalmeiro/itils
- Owner: joaopalmeiro
- License: mit
- Created: 2021-03-12T13:33:03.000Z (about 4 years ago)
- Default Branch: main
- Last Pushed: 2021-03-13T12:55:40.000Z (about 4 years ago)
- Last Synced: 2025-03-05T23:41:16.340Z (about 2 months ago)
- Topics: cli, image, image-processing, imagemagick, python
- Language: Python
- Homepage: https://pypi.org/project/itils/
- Size: 29.3 KB
- Stars: 1
- Watchers: 1
- Forks: 0
- Open Issues: 0
-
Metadata Files:
- Readme: README.md
- License: LICENSE
Awesome Lists containing this project
README
# itils
[](https://github.com/PyCQA/bandit)
[](https://github.com/psf/black)
A Python CLI for transforming images.
Powered by [plac](https://github.com/ialbert/plac) (CLI), [Wand](https://github.com/emcconville/wand) (images), and [halo](https://github.com/ManrajGrover/halo) (spinners).
## Usage
### Interactive mode
```text
itils -i
```
Run `quit` to close `itils`.
### `gslide` subcommand
```text
usage: itils gslide [-h] [-r PCT] input_img
Resize an image to be smaller than 25 megapixels for Google Slides.
The image can be resized using an explicit percentage as well.
positional arguments:
input_img The path to the image to be transformed.
optional arguments:
-h, --help show this help message and exit
-r PCT, --resize PCT The (explicit) percentage value (e.g., 70) to scale
both width and height. Values less than 100 reduce the
image size.
```
## Development
1. `poetry install`
2. `poetry shell`
## Notes
- `convert image.png -resize 70% smaller_image.png` ([documentation](http://www.imagemagick.org/script/convert.php)).
- ["Improve Windows Support"](https://github.com/manrajgrover/halo/issues/5) (open) issue (halo).