📸 SnapForge

Forge your images with a single chain of commands.

A lightweight, fast and intuitive Python library for image processing built on top of Pillow.

Perfect for resizing, filtering, enhancing and transforming images .

✨ Features

🚀 Fast & Lightweight: Minimal overhead for quick image tasks.
🔄 Format Conversion: Easily switch between JPEG, PNG, BMP, TIFF and more.
📏 Smart Resizing: High-quality scaling and resizing capabilities.
🛠️ Easy API: Designed with developer experience in mind—simple commands for complex tasks.
🐍 Pythonic: Follows Python's best practices for a seamless integration.
📷 Powered by Pillow: Uses the trusted Pillow library for reliable image processing.
⚡ Efficient Processing: Designed for smooth and practical image manipulation workflows.
🧾 MIT License: Open-source and free to use in personal and commercial projects.

🔄 Professional Format Converter 🔄

Our Storage.convert Supports more than 8 Formats : JPEG, JPG , PNG, WEBP, GIF, TIFF, BMP, ICO and etc.

📦 Installation

You can install SnapForge directly from PyPI using pip:

pip install snapforge

🚀 Quick Start

Here is a quick example to get you started with SnapForge:

from snapforge import Storage , Geometry

#                complete image path
img=Storage.load(r"...\img.png")
img=Geometry.round_corners(img,40)
img=Storage.save(img,"Round_corner.png")

📖 Available Modules

SnapForge is now fully modular 🔧 — each module has a single responsibility and can be imported independently:

from snapforge import Storage, Geometry, Effects, Overlays, Inspector, SnapForgeUpdater

📐 Geometry — resizing, cropping, rotating and transforming
💾 Storage — loading, saving and format conversion
🔍 Inspector — metadata, histogram and color analysis
🎨 Effects — lighting and filters
🖼️ Overlays — text, watermark, borders and blending
🔄 SnapForgeUpdater — update checks and version comparison

📦 Available Methods

Here is the complete list of all available methods in each snapforge module:

📐 Geometry

Method	Description	Example
`Geometry.resize(img, w, h)`	Change image dimensions	`Geometry.resize(img, 800, 600)`
`Geometry.thumbnail(img, w, h)`	Resize while keeping aspect ratio	`Geometry.thumbnail(img, 500, 500)`
`Geometry.fit(img, w, h)`	Resize and crop to exact dimensions	`Geometry.fit(img, 1080, 1080)`
`Geometry.crop(img, l, t, r, b)`	Crop image	`Geometry.crop(img, 0, 0, 100, 100)`
`Geometry.rotate(img, a)`	Rotate image	`Geometry.rotate(img, 90)`
`Geometry.flip(img, dir)`	Flip image	`Geometry.flip(img, "horizontal")`
`Geometry.round_corners(img, radius)`	Round image corners	`Geometry.round_corners(img, 40)`

💾 Storage

Method	Description	Example
`Storage.load(path)`	Load image from file	`Storage.load("photo.jpg")`
`Storage.save(img, name)`	Save image	`Storage.save(img, "result.jpg")`
`Storage.convert(img, fmt)`	Change image format (PNG, JPG, WEBP…)	`Storage.convert(img, "PNG")`
`Storage.optimize(img, q)`	Set JPEG quality	`Storage.optimize(img, 85)`

🔍 Inspector

Method	Description	Example
`Inspector.get_metadata(img)`	Extract detailed image metadata	`Inspector.get_metadata(img)`
`Inspector.histogram(img)`	Generate histogram data	`Inspector.histogram(img)`
`Inspector.compare(img)`	Display metadata and processing summary	`Inspector.compare(img)`
`Inspector.extract_color_palette(img)`	Get dominant colors as Hex codes	`Inspector.extract_color_palette(img)`

🎨 Effects (Lighting & Filters)

Method	Description	Example
`Effects.apply_brightness(img, f)`	Adjust brightness	`Effects.apply_brightness(img, 1.2)`
`Effects.apply_contrast(img, f)`	Adjust contrast	`Effects.apply_contrast(img, 1.5)`
`Effects.adjust_gamma(img, g)`	Correct image gamma	`Effects.adjust_gamma(img, 1.3)`
`Effects.auto_enhance(img)`	Improve brightness, contrast and sharpness	`Effects.auto_enhance(img)`
`Effects.invert(img)`	Invert image colors	`Effects.invert(img)`
`Effects.apply_sepia(img)`	Classic sepia effect	`Effects.apply_sepia(img)`
`Effects.apply_grayscale(img, f)`	Convert to grayscale	`Effects.apply_grayscale(img, 1.0)`
`Effects.apply_blur(img, r)`	Gaussian blur	`Effects.apply_blur(img, 5.0)`
`Effects.apply_sharpen(img, f)`	Sharpen image	`Effects.apply_sharpen(img, 1.0)`
`Effects.apply_camscanner(img)`	Document scanner effect	`Effects.apply_camscanner(img)`
`Effects.apply_preset(img, name)`	Apply a professional preset	`Effects.apply_preset(img, "vintage")`

🖼️ Overlays

Method	Description	Example
`Overlays.add_watermark(img, path)`	Add watermark	`Overlays.add_watermark(img, "logo.png")`
`Overlays.add_text(img, text, pos)`	Draw text	`Overlays.add_text(img, "Hello!", (50, 50))`
`Overlays.add_border(img, size, color)`	Add border	`Overlays.add_border(img, 10, (0, 0, 0))`
`Overlays.double_exposure(img, img2, mode)`	Blend with another image	`Overlays.double_exposure(img, "layer.png", "blend")`

🔄 SnapForgeUpdater

Method	Description	Example
`SnapForgeUpdater.__init__(package_name, current_version)`	Initialize the updater with the package name and current version	`SnapForgeUpdater("snapforge", "3.0.0")`
`SnapForgeUpdater._check_logic()`	Check PyPI in the background for a newer release	`updater._check_logic()`
`SnapForgeUpdater._notify_user(latest_version, upload_time)`	Display a notification when a new version is available	`updater._notify_user("3.0.1", "2026-08-12 10:30:00")`
`SnapForgeUpdater.start_check()`	Start the update check in a background daemon thread	`updater.start_check()`

🛠️ Requirements

To use SnapForge, ensure you have the following installed:

Python: 3.7 or higher
Dependencies:
- Pillow (for image processing)
- requests (for automatic update checks)
- packaging (for version comparison logic)

🤝 Contributing

Contributions are what make the open-source community such an amazing place to learn, inspire, and create. Any contributions you make are greatly appreciated.

🌟 More Projects

If you enjoy SnapForge, you might also like this project ,too:

PixSlim

A Python image and ... compression library focused on reducing file size while preserving quality.

📜 License

Distributed under the MIT License.

❤️ Support

If you find SnapForge useful, your support means a lot!

You can help by:

📦 Installing the package and trying it in your projects
📝 Sharing feedback and suggestions
🐛 Reporting bugs and improvements
🌟 Recommending SnapForge to other Python developers

🧩 Every piece of feedback helps make SnapForge better. 🙏

👤 Author

Ali.Shm

Project Maintainer

Metadata

Release files for snapforge 3.0.2

For a detailed explanation of source distributions (sdists) and built distributions (wheels), please see the package formats documentation.

Built distributions (wheels)

Table of built distributions (wheels) for snapforge 3.0.2
File	Interpreter	ABI	Platform	Reset
snapforge-3.0.2-py3-none-any.whl 182.4 kB Sep 2, 2026 Without provenance	Python 3	none	any	Details
snapforge-3.0.2-cp314-cp314-win_amd64.whl 182.4 kB Sep 2, 2026 Without provenance	CPython 3.14	CPython 3.14	Windows x86-64	Details

Total release size: 364.8 kB

Release files / snapforge-3.0.2-py3-none-any.whl

Download URL	snapforge-3.0.2-py3-none-any.whl
Size	182.4 kB
Tags	Python 3
SHA-256 checksum How to use checksums	`1cc24c48843b743adf0bfbfa056a8dc2425d225d9c4c59e53006cf77dd0e21a2`
BLAKE2b-256 checksum How to use checksums	`766049603f6be3434ed532decddd152e9815b95ad511d72d34c14f025548933a`
Upload date	Sep 2, 2026
Uploaded using Trusted Publishing? What is trusted publishing?	No
Uploaded via	`twine/7.0.0 CPython/3.14.7`

Release files / snapforge-3.0.2-cp314-cp314-win_amd64.whl

Download URL	snapforge-3.0.2-cp314-cp314-win_amd64.whl
Size	182.4 kB
Tags	CPython 3.14 Windows x86-64
SHA-256 checksum How to use checksums	`d71b49c0d7f514a1867a14891608f14c0ddcc044ad905048e2a81bb33a419f43`
BLAKE2b-256 checksum How to use checksums	`a483ab55c97a74965b2a22e836ac9528142b5bd76224c992ef601bbc165447dc`
Upload date	Sep 2, 2026
Uploaded using Trusted Publishing? What is trusted publishing?	No
Uploaded via	`twine/7.0.0 CPython/3.14.7`

Security for snapforge 3.0.2

Report project as malware

Provenance

Provenance describes where a file came from. On PyPI, provenance is shared via attestations, which provide a verifiable record of the build or publishing details. View details, limitations and caveats.

No provenance found

None of the files in this release were uploaded with provenance metadata.

A note on package security

PyPI is a repository for distributing packages, not a service for auditing them. While third-party security researchers and our staff do their best to detect and remove malicious packages, PyPI cannot guarantee the quality, security or suitability of any given package.