Magic Merge

by Alayna Ferdarko ✨

Version: 2.0

Release Date: 21 February, 2025

Update Date for Version 2: 24 March, 2025

What is Magic Merge? 🔮

Magic Merge is here to save your day (and your PDFs)! It's a sleek, easy-to-use tool that lets you merge multiple PDF files into one, effortlessly. No more messing around with complicated software or command-line tricks—just drag, drop, and merge!

Whether you're combining contracts, presentations, or personal files, Magic Merge helps you manage and organize your PDFs with ease. Plus, you get a progress bar to keep you in the loop as your documents come together like magic!

Features ✨

• Drag-and-Drop Support: Just drop your PDFs right into the app to start adding them to the merge list.
• Easy-to-Use Interface: Browse files, move documents up or down in the list, and remove items with simple buttons.
• Estimated File Size: Keep track of the total size of your PDFs with an accurate size estimate.
• Save Anywhere: Choose exactly where you want to save your newly merged PDF with the "Browse Save Location" button.
• Merge with a Click: Once everything’s in place, hit "Merge PDFs" and let Magic Merge handle the rest.
• Clear the List: If you make a mistake or change your mind, just click the "Clear List" button and start over!
• File Validation: Added validation to ensure that only PDF files are selected for merging.

How to Use 🛠️

1. Add PDFs:
   Click "Browse PDFs" to select your PDF files, or simply drag and drop them directly into the app window.

2. Manage Your PDFs:

   • You can remove any PDFs from the list by selecting them and clicking "Remove Selected".
   • If you want to change the order, just use the "Move Up" and "Move Down" buttons.

3. Select Save Location:
   Choose where you want to save your merged PDF by clicking "Browse Save Location".

4. Merge PDFs:
   Once you're happy with your selection, just click "Merge PDFs" and watch Magic Merge combine everything into one neat file.

5. Clear the List:
   If you want to start fresh, hit the "Clear List" button and all your selected PDFs will be removed from the list.

Heads-Up! ⚠️

• "Magic Merge" can only merge PDFs—no other file types, sorry! But it's all you need when you’re working with PDFs, right?
• Ensure your save location is selected before merging, or else the app won't know where to save your newly merged document.
• The progress bar will keep you updated, so you can sit back and relax while Magic Merge works its magic!

Installation from GitHub 🛠️

Ready to use Magic Merge? Here’s how to get it running on your system in just a few steps:

Step 1: Clone or Download the Repo

You can either clone the repository or download it directly from GitHub:

1. Clone the repository (if you're familiar with Git):

   git clone https://github.com/alaynavendetta/MagicMerge.git
   

2. Download the ZIP file:
   Head to the Magic Merge GitHub page, click the "Code" button, and select "Download ZIP". Then, extract the contents to a folder of your choice.

Step 2: Install Dependencies

Before you can run Magic Merge, you'll need to install a few Python libraries. To make things easier, we've provided a requirements.txt file, which contains all the dependencies you'll need.

1. Open a terminal or command prompt.

2. Navigate to the folder where you've cloned or downloaded Magic Merge.

3. Run the following command to install the required dependencies:

   pip install -r requirements.txt

This will ensure that Magic Merge has everything it needs to run smoothly! 🛠️

Step 3: Run the App

Once the dependencies are installed, you’re all set! To start Magic Merge, simply run the following command in your terminal (while in the Magic Merge directory):

python magicmerge.py

The executable files for Mac and Windows will be posted under releases for ease of install. All the required dependencies in the requirements.txt (you know, all two of them) will be packed in the .exe file. With that version it is basically plug and play, without having to tinker with python. This version here is for those who already have python and don't want or don't require things being packed in one easy to use format. If you don't already have or want python this is not the version for you.

---

Dependencies 📦

Magic Merge uses a few handy libraries to make everything come together, like magic! Here are the dependencies you'll need:

requirements.txt:

pymupdf               # PyMuPDF - For PDF manipulation
tkinterdnd2           # For drag-and-drop functionality

These libraries ensure smooth PDF merging, drag-and-drop functionality, and a stylish user interface. If you're using the provided requirements.txt, all the dependencies will be installed automatically. 🪄

Why "Magic Merge"?

Because it’s as easy as waving a wand! Well, almost… but it’s that simple to use. You can trust Magic Merge to merge your PDFs seamlessly, without the fuss, and you’ll be back to your work in no time. 🪄

License 📝

This software is free to use under the MIT License. Feel free to contribute, tweak, and share!

---

Enjoy merging your PDFs with Magic Merge—the quickest, easiest, and most magical way to combine documents!