Ecosyste.ms: Awesome
An open API service indexing awesome lists of open source software.
https://github.com/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.
https://github.com/cyberfantics/picpdf-maker
cyberfantics hacktoberfest hacktoberfest-accepted hacktoberfest2024 image-processing image-to-pdf jpeg-to-pdf open-source pngtopdf programming python pythonprojects streamlit web-application
Last synced: about 1 month ago
JSON representation
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.
- Host: GitHub
- URL: https://github.com/cyberfantics/picpdf-maker
- Owner: cyberfantics
- License: mit
- Created: 2024-10-12T14:14:15.000Z (3 months ago)
- Default Branch: main
- Last Pushed: 2024-11-25T03:47:46.000Z (about 1 month ago)
- Last Synced: 2024-11-25T04:29:17.392Z (about 1 month ago)
- Topics: cyberfantics, hacktoberfest, hacktoberfest-accepted, hacktoberfest2024, image-processing, image-to-pdf, jpeg-to-pdf, open-source, pngtopdf, programming, python, pythonprojects, streamlit, web-application
- Language: Python
- Homepage: https://cyberfantics-picpdf-maker-app-uwgfag.streamlit.app/
- Size: 1.14 MB
- Stars: 1
- Watchers: 1
- Forks: 0
- Open Issues: 0
-
Metadata Files:
- Readme: README.md
- License: LICENSE
Awesome Lists containing this project
README
# 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](https://cyberfantics-picpdf-maker-app-uwgfag.streamlit.app/)
## 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:**
```bash
git clone https://github.com/cyberfantics/picPDF-Maker.git
```
2. **Navigate to the project directory:**
```bash
cd picPDF-Maker
```
3. **Install the required dependencies:**
```bash
pip install -r requirements.txt
```
4. **Run the Streamlit app:**
```bash
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](https://www.linkedin.com/in/mansoor-bukhari-77549a264/)
## License 📜
This project is open-source and available under the [MIT License](LICENSE).