Skip to content

A simple desktop application to merge images with drag-and-drop functionality, built using PyQt6.

License

Notifications You must be signed in to change notification settings

yilmaz-mert/PicFusion

Repository files navigation

PicFusion

PicFusion is a simple yet powerful tool that allows you to merge multiple images vertically, horizontally, or in a grid into a single image. You can reorder the images in the list and save the final merged result

image

Features

  • Drag-and-drop support: Easily drag and drop images into the application.
  • Reordering: Change the order of images before merging.
  • Vertical, horizontal, and grid merging: Combine selected images vertically, horizontally, or in a grid layout into one.
  • Save merged image: Save the final merged image in various formats (e.g., .png, .jpg).

Requirements

To run this project locally, you will need the following Python packages:

  • PyQt6
  • Pillow

Installation and Running Locally

  1. Clone the repository:

    git clone https://github.com/yilmaz-mert/PicFusion.git
    cd PicFusion
  2. Install the required Python packages:

    pip install -r requirements.txt
  3. Run the application:

    python PicFusionApp.py

Usage Options

1. Using the Precompiled Executable

For convenience, you can directly use the precompiled executable file PicFusion.exe provided in this repository. You can find it in the dist folder.

  • Steps to Use:
    • Download the PicFusion.exe file.
    • Double-click to run the application.
    • No additional installation is required.

2. Build the Executable Yourself (Optional)

If you'd like to build the .exe file yourself, follow these steps:

  1. Install PyInstaller:

    pip install pyinstaller
  2. Use PyInstaller to compile the application:

    pyinstaller --onefile --icon=icon.ico PicFusionApp.py
  3. The compiled .exe file will be available in the dist folder.

How It Works

  1. Add Images: Drag and drop image files into the application, or use the "Add Images" button to select files.
  2. Preview and Rearrange: Preview the images and rearrange them in the desired order.
  3. Resize Images (Optional): Optionally, resize the images before merging them.
  4. Merge Images: Choose the merge option (vertical, horizontal, or grid) and click the "Merge Images" button to combine the images.
  5. Save Merged Image: Save the final merged image to your preferred location in various formats (e.g., .png, .jpg).
  6. Notifications: Receive notification messages when the save operation is either completed or canceled.

License

This project is licensed under the MIT License. See the LICENSE file for details.