# 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 direct <input_image> <final_width> <final_height> [--blur <blur_radius>]
thumber aspect <input_image> <ratio> [--blur <blur_radius>]
thumber crop <input_image> {--ratio <aspect_ratio> | --width <crop_width> --height <crop_height>}
```
Values for `<mode>`:
- `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.
Raw data
{
"_id": null,
"home_page": null,
"name": "thumber",
"maintainer": "lvxvvv",
"docs_url": null,
"requires_python": ">=3.8",
"maintainer_email": null,
"keywords": "thumbnail, image, filter, ratio, aspect ratio, crop",
"author": "lvxvvv",
"author_email": null,
"download_url": "https://files.pythonhosted.org/packages/c3/c4/54bb0bc8a5d4960ffd4d0679e6e42677413674c90d83f2d3471322f7cb10/thumber-0.3.0.tar.gz",
"platform": null,
"description": "# Thumber\n\nCreate 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.\n\nInstall using pip:\n\n```\npip install thumber\n```\n\n## Usage\n\n```\nthumber direct <input_image> <final_width> <final_height> [--blur <blur_radius>]\n\nthumber aspect <input_image> <ratio> [--blur <blur_radius>]\n\nthumber crop <input_image> {--ratio <aspect_ratio> | --width <crop_width> --height <crop_height>}\n```\n\n\nValues for `<mode>`:\n \n- `dimensions`\n- `aspect`\n- `crop`\n\n\nExamples:\n\n- Produce a 1920x1080 image:\n\n```\nthumber dimensions image.png 1920 1080 --blur=30\n```\n\n- Produce an image whose width is 1.778x the height:\n\n```\nthumber aspect image.png 1.778 --blur=30\n```\n\nThe closer to 0, the lower is the blur effect\n\n\n- Produce a cropped image, without blur in the background:\n\n```\nthumber crop image.png --ratio=1.778\n```\n\n```\nthumber crop image.png --width=1920 --heigth=1080\n```\n\n## Gallery Examples\n\n\n| `babel.webp` (1024x1024)| `babel-dimensions-1920x1080.webp` | `babel-aspect-0.5.webp` | `babel-aspect-2.webp` | `babel-cropped-1920x1080.webp`|\n|:----:|:----:|:-----:|:----:|:----:|\n| |  |  |  | \n\n\n## License \n\nThis project is licensed under the MIT License.\n",
"bugtrack_url": null,
"license": null,
"summary": "Create thumbnails. Specify dimensions or aspect ratio.",
"version": "0.3.0",
"project_urls": {
"Changelog": "https://github.com/lvxvvv/thumber/blob/main/CHANGELOG.md",
"Homepage": "https://github.com/lvxvvv/thumber",
"Issues": "https://github.com/lvxvvv/thumber/issues",
"Mastodon": "https://mastodon.social/@lvxvvv",
"Repository": "https://github.com/lvxvvv/thumber.git",
"Twitter": "https://x.com/lvxvvv"
},
"split_keywords": [
"thumbnail",
" image",
" filter",
" ratio",
" aspect ratio",
" crop"
],
"urls": [
{
"comment_text": null,
"digests": {
"blake2b_256": "379de92b79089e3b46aa78d2e2075e2a154839c60b6cecbfeace081073f03041",
"md5": "a56c4a3b9ec287298b88ab105f2cb9d6",
"sha256": "76e39bb929d7b8b32b1c8d6bff1147d7d9401099f2f13994928ca1b242cc4e17"
},
"downloads": -1,
"filename": "thumber-0.3.0-py3-none-any.whl",
"has_sig": false,
"md5_digest": "a56c4a3b9ec287298b88ab105f2cb9d6",
"packagetype": "bdist_wheel",
"python_version": "py3",
"requires_python": ">=3.8",
"size": 5193,
"upload_time": "2025-02-25T23:27:44",
"upload_time_iso_8601": "2025-02-25T23:27:44.788443Z",
"url": "https://files.pythonhosted.org/packages/37/9d/e92b79089e3b46aa78d2e2075e2a154839c60b6cecbfeace081073f03041/thumber-0.3.0-py3-none-any.whl",
"yanked": false,
"yanked_reason": null
},
{
"comment_text": null,
"digests": {
"blake2b_256": "c3c454bb0bc8a5d4960ffd4d0679e6e42677413674c90d83f2d3471322f7cb10",
"md5": "f649d57e7b7f9633835ba5adfbb2d1ac",
"sha256": "63032e5056713d161b35597f51012e1aa1bccda3f3b92463ec43b6a1912c1364"
},
"downloads": -1,
"filename": "thumber-0.3.0.tar.gz",
"has_sig": false,
"md5_digest": "f649d57e7b7f9633835ba5adfbb2d1ac",
"packagetype": "sdist",
"python_version": "source",
"requires_python": ">=3.8",
"size": 4950,
"upload_time": "2025-02-25T23:27:47",
"upload_time_iso_8601": "2025-02-25T23:27:47.115385Z",
"url": "https://files.pythonhosted.org/packages/c3/c4/54bb0bc8a5d4960ffd4d0679e6e42677413674c90d83f2d3471322f7cb10/thumber-0.3.0.tar.gz",
"yanked": false,
"yanked_reason": null
}
],
"upload_time": "2025-02-25 23:27:47",
"github": true,
"gitlab": false,
"bitbucket": false,
"codeberg": false,
"github_user": "lvxvvv",
"github_project": "thumber",
"travis_ci": false,
"coveralls": false,
"github_actions": false,
"requirements": [
{
"name": "pillow",
"specs": [
[
"==",
"11.1.0"
]
]
},
{
"name": "thumber",
"specs": [
[
"==",
"0.3.0"
]
]
}
],
"lcname": "thumber"
}
JSON
