https://github.com/veralvx/thumber
Create thumbnails. Specify dimensions or aspect ratio. Resizes and blurs background if aspect ratio changes.
https://github.com/veralvx/thumber
aspect-ratio blur cover cover-image crop crop-image dimensions image image-blur image-processing images thumbnail thumbnail-generator thumbnails
Last synced: 2 months ago
JSON representation
Create thumbnails. Specify dimensions or aspect ratio. Resizes and blurs background if aspect ratio changes.
- Host: GitHub
- URL: https://github.com/veralvx/thumber
- Owner: veralvx
- License: mit
- Created: 2025-02-25T13:09:01.000Z (3 months ago)
- Default Branch: main
- Last Pushed: 2025-02-25T23:30:34.000Z (3 months ago)
- Last Synced: 2025-03-02T23:04:56.015Z (3 months ago)
- Topics: aspect-ratio, blur, cover, cover-image, crop, crop-image, dimensions, image, image-blur, image-processing, images, thumbnail, thumbnail-generator, thumbnails
- Language: Python
- Homepage:
- Size: 1.17 MB
- Stars: 0
- Watchers: 1
- Forks: 0
- Open Issues: 0
-
Metadata Files:
- Readme: README.md
- Changelog: CHANGELOG.md
- License: LICENSE
Awesome Lists containing this project
README
# Thumber
Create thumbnails. Specify dimensions or aspect ratio. If the aspect ratio from the input image is altered, fills the background with the same image, but blurred. Alternatively, just crop it without blur.
Install using pip:
```
pip install thumber
```
## Usage
```
thumber dimensions [--blur ]
thumber aspect [--blur ]
thumber crop {--ratio | --width --height }
```
Values for ``:
- `dimensions`
- `aspect`
- `crop`
Examples:
- Produce a 1920x1080 image:
```
thumber dimensions image.png 1920 1080 --blur=30
```
- Produce an image whose width is 1.778x the height:
```
thumber aspect image.png 1.778 --blur=30
```
The closer to 0, the lower is the blur effect
- Produce a cropped image, without blur in the background:
```
thumber crop image.png --ratio=1.778
```
```
thumber crop image.png --width=1920 --heigth=1080
```
## Gallery Examples
| `babel.webp` (1024x1024)| `babel-dimensions-1920x1080.webp` | `babel-aspect-0.5.webp` | `babel-aspect-2.webp` | `babel-cropped-1920x1080.webp`|
|:----:|:----:|:-----:|:----:|:----:|
| |  |  |  | 
## License
This project is licensed under the MIT License.