PixSlim

PixSlim is a lightweight and easy-to-use Python package for compressing images, PDF, and Microsoft Word documents while maintaining the best possible quality.

---

✨ Features

Feature	Status
🖼 Image Compression	✅
📄 PDF Compression	✅
📝 DOCX Compression	✅
🎯 Target File Size	✅
⚡ Fast & Lightweight	✅
🐍 Python 3.9+	✅

---

📦 Installation

pip install Pixslim

---

🚀 Quick Start

from Pixslim import compressor

compressor = compressor(target_kb=500)

result = compressor.compress(
    "input.jpg",
    "output.jpg"
)

print(result)

Example Output

{
    "original_kb": 1523.45,
    "final_kb": 487.31,
    "reduction_percent": 68.01,
    "quality": 80,
    "size": (1920, 1080)
}

---

📂 Supported Formats

📂 Category	📁 Formats	🚀 Supported
🖼 Images	JPG, JPEG, PNG, BMP, TIFF, WEBP	✅
📄 Documents	PDF, DOCX	✅

---

📚 Dependencies

📦 Package	Purpose
Pillow	Image compression
PyMuPDF	PDF optimization
python-docx	Microsoft Word document handling

Install manually if needed:

pip install Pillow PyMuPDF python-docx

---

📖 API

Create a Compressor

compressor = compressor(target_kb=500)

Compress a File

result = compressor.compress(
    input_file="input.pdf",
    output_file="output.pdf"
)

---

📊 Return Value

PixSlim returns a dictionary like this:

{
    "original_kb": 1024.55,
    "final_kb": 498.23,
    "reduction_percent": 51.37,
    "quality": 80,
    "size": (1920, 1080)
}

---

📋 Project Information

Property	Value
Package Name	Pixslim
Version	1.1.0
Python	3.9+
License	MIT
Author	Fatemeh SHM

---

📄 License

This project is licensed under the MIT License.

---

🌟 More Projects

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

snapforge

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

---

❤️ About

Thank you for using PixSlim.

If PixSlim helps you, consider sharing it with other Python developers.

---

Author

Fatemeh SHM