Skip to content

README.md

Latest commit

 

History

History
62 lines (46 loc) · 2.53 KB

README.md

File metadata and controls

62 lines (46 loc) · 2.53 KB
Raw

PDF Merger Pro - Smart Edition

PDF Merger Pro adalah sebuah alat bantu berbasis terminal (CLI) yang ditulis dengan Python untuk menggabungkan beberapa file PDF menjadi satu. Alat ini dilengkapi dengan mode "Smart Detect" yang dapat secara otomatis mengidentifikasi dan menggabungkan file-file yang memiliki relasi berdasarkan prefix nama file.

Fitur

  • Lingkungan Interaktif: Setup folder input dan output langsung dari terminal.
  • Mode Auto Merge (Smart Detect): Secara otomatis menemukan file-file yang berhubungan (misalnya Laporan.pdf dan MCM-Laporan.pdf) dan menggabungkannya sesuai urutan yang diinginkan. Fitur ini case-insensitive dan dapat mendeteksi separator (-, _, atau spasi) secara otomatis.
  • Mode Manual Merge: Pilih secara manual file-file PDF yang ingin Anda gabungkan.
  • Cross-Platform: Dapat dijalankan di Windows, macOS, dan Linux.

Kebutuhan Sistem

  • Python 3.x
  • pip (Python package installer)

Instalasi & Penggunaan

  1. Clone Repositori:

    git clone https://github.com/NAMA_USER/NAMA_REPO.git
cd NAMA_REPO

  2. Install Dependensi: Alat ini membutuhkan library pypdf dan tqdm. Install dengan perintah:

    pip install pypdf tqdm

  3. Siapkan File PDF:

    • Buat sebuah folder bernama input di dalam direktori proyek.
    • Masukkan semua file PDF yang ingin Anda proses ke dalam folder input tersebut.

  4. Jalankan Program: Eksekusi program melalui terminal:

    python main.py

    Program akan memandu Anda melalui menu utama untuk memilih mode penggabungan. Hasil file PDF akan disimpan di dalam folder output.

Cara Membuat File Executable (Build)

Anda bisa mem-package aplikasi ini menjadi satu file executable tunggal sehingga bisa dijalankan tanpa perlu menginstall Python atau dependensi lainnya. Kita akan menggunakan PyInstaller.

  1. Install PyInstaller:

    pip install pyinstaller

  2. Buat Executable: Jalankan perintah berikut dari direktori utama proyek:

    pyinstaller --onefile --name "PDFMergerPro" main.py
    • --onefile: Menggabungkan semua menjadi satu file executable.
    • --name "PDFMergerPro": Memberi nama pada file hasil build.

  3. Temukan Executable: File PDFMergerPro (atau PDFMergerPro.exe di Windows) akan berada di dalam folder dist. Anda bisa menyalin file ini ke mana saja dan menjalankannya. Folder input dan output akan secara otomatis dicari/dibuat di lokasi yang sama dengan file executable tersebut.