Update to v2.0.0: Added Drag & Drop and Auto-Open features

Author: SETYUTH

PDFMerger_v2.py

@@ -0,0 +1,180 @@
+import tkinter as tk
+from tkinter import filedialog, messagebox
+from tkinterdnd2 import DND_FILES, TkinterDnD
+from pypdf import PdfWriter
+import os
+
+# --- CONFIGURATION ---
+VERSION = "2.0.0"
+APP_NAME = "PDF Merger Utility"
+
+
+def show_about():
+    """Displays a popup with app information."""
+    messagebox.showinfo(
+        "About",
+        f"{APP_NAME}\n"
+        f"Version: {VERSION}\n\n"
+        "A simple tool to merge PDFs in your preferred order.\n"
+        "Licensed under MIT."
+    )
+
+# --- LOGIC ---
+
+def add_files():
+    """Manual selection of files via button."""
+    files = filedialog.askopenfilenames(
+        title="Select PDF files",
+        filetypes=[("PDF Files", "*.pdf")]
+    )
+    for file in files:
+        listbox.insert(tk.END, file)
+
+
+def drop_files(event):
+    """Handles dragging and dropping files into the listbox."""
+    # The event.data returns a string of filenames.
+    # We need to clean curly braces {} which Windows adds to paths with spaces.
+    raw_files = event.data
+
+    # This logic splits the dropped items into individual paths
+    # Note: TkinterDnD can be tricky with spaces, this is a basic parser
+    if raw_files.startswith('{'):
+        paths = raw_files[1:-1].split('} {')
+    else:
+        paths = raw_files.split()
+
+    for path in paths:
+        if path.lower().endswith('.pdf'):
+            listbox.insert(tk.END, path)
+
+
+def move_up():
+    """Moves selected item up."""
+    try:
+        selection = listbox.curselection()
+        if not selection or selection[0] == 0: return
+        pos = selection[0]
+        text = listbox.get(pos)
+        listbox.delete(pos)
+        listbox.insert(pos - 1, text)
+        listbox.selection_set(pos - 1)
+    except:
+        pass
+
+
+def move_down():
+    """Moves selected item down."""
+    try:
+        selection = listbox.curselection()
+        if not selection or selection[0] == listbox.size() - 1: return
+        pos = selection[0]
+        text = listbox.get(pos)
+        listbox.delete(pos)
+        listbox.insert(pos + 1, text)
+        listbox.selection_set(pos + 1)
+    except:
+        pass
+
+
+def remove_selected():
+    """Removes selected item."""
+    try:
+        selection = listbox.curselection()
+        if selection: listbox.delete(selection[0])
+    except:
+        pass
+
+
+def merge_pdfs():
+    """Merges files and auto-opens the folder."""
+    files = listbox.get(0, tk.END)
+
+    if len(files) == 0:
+        messagebox.showwarning("Warning", "No files to merge!")
+        return
+
+    save_path = filedialog.asksaveasfilename(
+        title="Save Merged File",
+        defaultextension=".pdf",
+        filetypes=[("PDF Files", "*.pdf")]
+    )
+
+    if not save_path: return
+
+    merger = PdfWriter()
+    try:
+        for pdf in files:
+            merger.append(pdf)
+
+        merger.write(save_path)
+        merger.close()
+
+        # --- FEATURE: AUTO-OPEN FOLDER ---
+        folder_path = os.path.dirname(save_path)
+        os.startfile(folder_path)
+
+        messagebox.showinfo("Success", f"Saved to:\n{save_path}")
+
+    except Exception as e:
+        messagebox.showerror("Error", f"Failed: {e}")
+
+
+# --- GUI SETUP ---
+# We use TkinterDnD.Tk instead of tk.Tk
+root = TkinterDnD.Tk()
+root.title(f"{APP_NAME} - v{VERSION}")
+root.geometry("600x450")
+
+# --- ADDING A MENU BAR ---
+menubar = tk.Menu(root)
+helpmenu = tk.Menu(menubar, tearoff=0)
+helpmenu.add_command(label="About", command=show_about)
+menubar.add_cascade(label="Help", menu=helpmenu)
+root.config(menu=menubar)
+
+# 1. Header with Instructions
+lbl_instruct = tk.Label(root, text="Drag & Drop PDF files here", font=("Arial", 10, "italic"), fg="gray")
+lbl_instruct.pack(pady=(10, 0))
+
+# 2. The Listbox (With Drag & Drop Enabled)
+frame_list = tk.Frame(root)
+frame_list.pack(fill="both", expand=True, padx=15, pady=5)
+
+scrollbar = tk.Scrollbar(frame_list)
+scrollbar.pack(side="right", fill="y")
+
+listbox = tk.Listbox(frame_list, selectmode=tk.SINGLE, yscrollcommand=scrollbar.set, font=("Consolas", 9))
+listbox.pack(side="left", fill="both", expand=True)
+scrollbar.config(command=listbox.yview)
+
+# ENABLE DRAG AND DROP ON LISTBOX
+listbox.drop_target_register(DND_FILES)
+listbox.dnd_bind('<<Drop>>', drop_files)
+
+# 3. Control Buttons
+frame_controls = tk.Frame(root)
+frame_controls.pack(fill="x", padx=15, pady=5)
+
+btn_add = tk.Button(frame_controls, text="➕ Add Manually", command=add_files)
+btn_add.pack(side="left")
+
+btn_remove = tk.Button(frame_controls, text="❌ Remove", command=remove_selected)
+btn_remove.pack(side="left", padx=5)
+
+btn_down = tk.Button(frame_controls, text="↓", command=move_down, width=3)
+btn_down.pack(side="right")
+
+btn_up = tk.Button(frame_controls, text="↑", command=move_up, width=3)
+btn_up.pack(side="right", padx=5)
+
+# 4. Merge Button
+btn_merge = tk.Button(root, text="MERGE NOW", command=merge_pdfs, bg="#007ACC", fg="white", font=("Arial", 11, "bold"),
+                      height=2)
+btn_merge.pack(fill="x", padx=15, pady=10)
+
+# 5. Version Badge (Bottom Right)
+lbl_version = tk.Label(root, text=f"v{VERSION}", font=("Arial", 8), fg="#999")
+lbl_version.pack(side="bottom", anchor="se", padx=5, pady=2)
+
+root.mainloop()

README.md

@@ -1,105 +1,70 @@
 # PDF Merger Utility
 
-A lightweight, user-friendly Windows desktop application built with Python to combine multiple PDF files into a single document. This tool allows users to import PDFs, reorder them manually to ensure the correct sequence, and export the final result with one click.
+A lightweight, user-friendly Windows desktop application built with Python to combine multiple PDF files into a single document. Version 2.0.0 introduces a modern Drag-and-Drop interface and workflow automation.
 
-## ✨ Features
+![Version](https://img.shields.io/badge/version-2.0.0-blue)
+![License](https://img.shields.io/badge/license-MIT-green)
 
-* **Batch Import:** Add multiple PDF files at once.
-* **Manual Reordering:** Use "Move Up" and "Move Down" buttons to organize your files exactly how you want them in the final document.
-* **Remove Tool:** Easily remove accidental additions from the list.
-* **Clean UI:** Simple, no-nonsense interface for quick tasks.
-* **Open Source:** Free to use, modify, and distribute under the MIT License.
+## ✨ New in v2.0.0
+* **Drag & Drop Support:** You can now drag files directly from your desktop into the app window.
+* **Auto-Open:** The folder containing your merged file opens automatically after processing.
+* **UI Improvements:** Added version badge and instructional prompts.
 
-## 🚀 Getting Started
+## 🚀 Features
+* **Batch Import:** Add multiple PDF files via file browser or Drag & Drop.
+* **Manual Reordering:** Use "Move Up" and "Move Down" buttons to ensure the perfect page sequence.
+* **Smart Parsing:** Automatically handles file paths even if they contain spaces.
+* **Standalone Utility:** Can be built into a single `.exe` file that runs without Python installed.
 
-### Prerequisites
-
-To run this tool from the source code, you need:
+## 🛠️ Installation & Setup
 
-* **Python 3.x** installed on your system.
-* The `pypdf` library.
-
-### Installation
+### Prerequisites
+To run the source code, you need **Python 3.x** and the following libraries:
 
-1. **Clone the repository:**
 ```bash
-git clone https://github.com/YOUR_USERNAME/PDF-Merger-Utility.git
-cd PDF-Merger-Utility
-
+pip install pypdf tkinterdnd2 pyinstaller
 ```
 
+### Running the App
 
-2. **Install dependencies:**
 ```bash
-pip install pypdf
-
+python PDFMerger_v2.py
 ```
 
+## 📦 How to Build the Executable (.exe)
 
-3. **Run the application:**
-```bash
-python PDFMerger.py
+**Important:** Because this version uses `tkinterdnd2` for drag-and-drop, the build command is different from standard Python scripts. You must use the `--collect-all` flag to include the necessary system hooks.
 
+1. Open your terminal/command prompt.
+2. Run the following command:
+```bash
+pyinstaller --noconsole --onefile --collect-all tkinterdnd2 PDFMerger_v2.py
 ```
 
-
-
----
+3. Your standalone application will appear in the `dist/` folder.
 
 ## 📖 User Guide
 
-Using the PDF Merger is straightforward:
-
-1. **Add Files:** Click the **Add Files...** button to select the PDFs you want to combine.
-2. **Organize:** * Click on a file name in the list to select it.
-* Click **Move Up ↑** or **Move Down ↓** to change the order. The final PDF will be merged from top to bottom.
-
-
-3. **Remove:** If you made a mistake, select the file and click **Remove Selected**.
-4. **Merge:** Click the green **MERGE PDFS** button. A window will pop up asking you where to save your new file and what to name it.
-5. **Success:** Once the process is complete, a success message will appear.
-
----
-
-## 🛠️ How to Build an Executable (.exe)
-
-If you want to create a standalone version that runs without Python:
-
-1. Install PyInstaller: `pip install pyinstaller`
-2. Run: `pyinstaller --onefile --noconsole PDFMerger.py`
-3. Find your `PDFMerger.exe` in the `dist` folder.
-
----
+1. **Launch:** Open `PDFMerger Utility`.
+2. **Add Files:** Drag PDF files into the white box, or click **➕ Add Manually**.
+3. **Organize:** Select a file and use the **↑** or **↓** arrows to change the order.
+4. **Merge:** Click **MERGE NOW**.
+5. **Finish:** Choose a save location. The folder will open automatically once done.
 
 ## 📄 License
+This project is licensed under the MIT License - see the [LICENSE](https://www.google.com/search?q=LICENSE) file for details.
 
-This project is licensed under the **MIT License**.
-
-```text
-MIT License
-
-Copyright (c) 2026 Yuth Set
-
-Permission is hereby granted, free of charge, to any person obtaining a copy
-of this software and associated documentation files (the "Software"), to deal
-in the Software without restriction, including without limitation the rights
-to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
-copies of the Software, and to permit persons to whom the Software is
-furnished to do so, subject to the following conditions:
+---
 
-The above copyright notice and this permission notice shall be included in all
-copies or substantial portions of the Software.
+### 🚀 Major Update: v2.0.0
 
-THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
-IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
-FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
-AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
-LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
-OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
-SOFTWARE.
+This release focuses on User Experience (UX) improvements, making it faster and easier to merge documents.
 
-```
+### 🆕 What's New
+- **Drag & Drop Support:** Completely replaced the static list view with a Drop-enabled zone. Users can now drag PDFs directly from Explorer into the app.
+- **Workflow Automation:** The application now automatically opens the destination folder after a successful merge, saving you the extra clicks to find your file.
+- **UI Polish:** Added clear instructional text and a version badge to the interface.
+- **Bug Fixes:** Improved file path parsing for filenames containing spaces.
 
----
-## Current Version
-**v1.0.0** (Initial Release)
+### 📦 How to Use
+Download the `PDFMerger.exe` attached below. No installation is required—just double-click and run!