Ecosyste.ms: Awesome

An open API service indexing awesome lists of open source software.

Awesome Lists | Featured Topics | Projects

https://github.com/rozhakxd/pfcomp


https://github.com/rozhakxd/pfcomp

file-optimization flask ghostscript pdf-compression python tailwind-css

Last synced: 8 days ago
JSON representation

Awesome Lists containing this project

README

        

# 🌟 PFComp - Your Ultimate PDF Compressor
![PFComp](https://github.com/user-attachments/assets/40ce36fe-4e21-492a-a82c-14653abdf9e6)

PFComp is a modern web application designed to compress PDF files quickly and efficiently 📄✨. With its sleek design and powerful backend, PFComp ensures top-notch file compression without compromising quality.

## 🚀 Features
- 🏆 **High-Quality Output**: Keeps your documents sharp while reducing file size.
- ⚡ **Lightning-Fast Compression**: High-speed backend processing for minimal wait times.
- 🖌 **Intuitive Interface**: Clean, responsive, and easy to navigate with Tailwind CSS.
- 🌍 **Cross-Platform**: Compatible with all devices and browsers.

## 🛠️ Tech Stack
- **Frontend**: HTML, Tailwind CSS, JavaScript
- **Backend**: Flask (Python)
- **File Handling**: Seamless `.pdf` file compression

## 🔧 Installation and Setup
### Prerequisites
- 🐍 Python 3.9+
- 📦 pip (Python package manager)
- 📄 Ghostscript (for PDF compression)

### Steps
1. Clone the repository:
```bash
git clone https://github.com/RozhakXD/PFComp.git
cd PFComp
```

2. Create a virtual environment and activate it:
```bash
python -m venv venv
source venv/bin/activate # On Windows: venv\Scripts\activate
```

3. Install dependencies:
```bash
pip install -r requirements.txt
```

4. Run the application:
```bash
python run.py
```

5. Open your browser and go to:
```
http://127.0.0.1:5000
```

## 💡 Usage
1. Open the application in your browser.
2. Drag and drop or select a `.pdf` file in the **Upload PDF File** section.
3. Click **Compress PDF** to start the process.
4. Download your optimized file in seconds ⏱️.

## 🖼️ Screenshots
![PFComp Images](https://github.com/user-attachments/assets/3e4fae84-cab3-457f-afac-319767a65a5c)

## 🛠️ Troubleshooting
- **File Upload Not Working?** Ensure the file format is `.pdf` and does not exceed the size limit.
- **Application Not Starting?** Check your Python and pip versions, and ensure all dependencies are installed.
- **Compression Issues?** Make sure the uploaded file is not corrupted or try restarting the application.
- **Ghostscript Not Installed?** Verify Ghostscript is installed and accessible from the command line.
- On Linux/Termux, install with:

```bash
pkg install ghostscript
```
- On other platforms, download it from [Ghostscript official site](https://www.ghostscript.com/).

## ❤️ Support Us
If you love this project and want to support its development, consider buying us a coffee or leaving a tip:
- [☕ Trakteer](https://trakteer.id/rozhak_official/tip)
- [💸 PayPal](https://paypal.me/rozhak9)
- [🎁 Saweria](https://saweria.co/rozhak9)

## 📜 License
This project is licensed under the [MIT License](LICENSE).