cyberfantics / picPDF-Maker

picPDF Maker is a simple web app that converts images into customizable PDF files. With options for page size, orientation, margins, and colors, users can create high-quality PDFs easily. The app also features a dark mode for a better viewing experience.

picPDF Maker 📄🖼️

Welcome to picPDF Maker! This Streamlit-based application allows you to convert images into high-quality PDF files with customizable layout options.

Live Demo 🌐

You can try out the application here: picPDF Maker

Features 🚀

• Upload multiple images in various formats (JPEG, JPG, PNG, GIF, TIFF) 🖼️
• Customize PDF layout options, including page size, orientation, margins, and background colors 📏🎨
• Dark mode toggle for a better viewing experience in low-light environments 🌙
• Simple user interface with menu options for easy navigation 🏠
• Download the generated PDF with a single click 📥

Installation 🛠️

To run this application locally, follow these steps:

1. Clone the repository:

   git clone https://github.com/cyberfantics/picPDF-Maker.git

2. Navigate to the project directory:

   cd picPDF-Maker

3. Install the required dependencies:

   pip install -r requirements.txt

4. Run the Streamlit app:

   streamlit run app.py

Dependencies 📦

The application uses the following Python libraries:

• streamlit - For creating the web app interface
• Pillow - For image processing (resizing, cropping, etc.)
• fpdf - For creating PDF files

These dependencies are specified in the requirements.txt file.

Usage 📋

1. Home 🏠: An introduction to the application, outlining its features and capabilities.
2. Convert 📄:
   • Upload your images (JPEG, JPG, PNG, GIF, TIFF) in the "Convert" section.
   • Adjust layout options like page size, orientation, margins, and colors.
   • Click "Convert to PDF 📄" to generate the PDF.
   • Download the generated PDF file.
3. About Us 👨‍💻: Learn more about the developer and reach out for inquiries or collaborations.

Dark Mode 🌙

The app includes a dark mode toggle for a comfortable experience in low-light conditions. When enabled, the app's background and components are styled with dark colors for improved visibility.

Customization Options 📝

Page Layout

• Page Size: Choose between A4 and Letter sizes.
• Orientation: Select either Portrait or Landscape.
• Margins: Adjust the top, bottom, left, and right margins.
• Colors: Set custom colors for margins and background.

Troubleshooting 🐛

If you encounter any issues, make sure that:

• All dependencies are installed correctly using the requirements.txt file.
• The image files being uploaded are supported formats (JPEG, JPG, PNG, GIF, TIFF).

Contributing 🤝

Contributions are welcome! Please feel free to submit a pull request or report issues.

Contact 📧

Developer: Syed Mansoor ul Hassan Bukhari
LinkedIn

License 📜

This project is open-source and available under the MIT License.