PDFize

Brief

Just a simple command-line tool for converting PDF files into images, with support for multiprocessing to enhance performance.

Third Party Library

🔮 EXCEPTIONS
The executable bundles generated by PyInstaller from your source code can be shipped with whatever license you want. See more about the license of PyInstaller.

1. PyMuPDF : AGPL 3.0
2. Pillow : HPND
3. click : BSD
4. tqdm : MIT, MPL 2.0
5. pyinstaller : GPLv2

Help

• general options

  • --pbar/--no-pbar : 開啟命令行進度條 (flag)

  • -s | --style : 進度條樣式

    ASCII_GRADIENT :  ░▒▓█
    ASCII_PIXEL    :  ▖▘▝▗▚▞█
    ASCII_SQUARE   :  ▨■
    ASCII_CIRCLE   :  ○◐⬤
    ASCII_SPEED    :  ▱▰
    ASCII_DOT      :  ⣀⣦⣿
    ASCII_BOX      :  ▯▮

• command

  • img-to-pdf : image 轉 PDF

    • -o | --output : 指定 pdf 檔案名稱

      pdfize img-to-pdf "input.jpeg" -o "output.pdf"
      pdfize img-to-pdf "images_dir/" -o "output.pdf"

  • pdf-to-img : PDF 轉 image

    • -d | --dpi : 指定 image 解析度 (預設: 100)

      pdfize pdf-to-img "input.pdf" -o "output/" -d 400

    • -f | --format : 指定 image 格式 (預設: png)

      pdfize pdf-to-img "input.pdf" -o "imgdir/" -f "webp"

    • -n | --name : 指定 image 主名稱 (預設: 同輸入 pdf 名稱)

      pdfize pdf-to-img "input.pdf" -o "imgdir/" -n "output"

    • -o | --output : 指定 image 目錄名稱

      pdfize pdf-to-img "input.pdf" -o "imgdir/"

    • --parallel : 開啟多進程平行執行 (flag)

      pdfize pdf-to-img "input.pdf" -o "imgdir/" --parallel

    • --subdir : 有多個 pdf 時，以原 pdf 名稱作為子目錄 (flag)

      pdfize pdf-to-img "pdfs_dir/" -o "result/" --subdir

    • -w | --worker : 若有開啟多進程平行執行，選擇使用幾顆 cores 加速

      開很多 process 速度加倍，但會吃非常多記憶體

      pdfize pdf-to-img "pdfs_dir/" -o "result/" --parallel -w 4 

  • split : PDF 拆分

    • -o | --output : 輸出 pdf 檔案

      pdfize split "input.pdf" -r 2 5 -o "output.pdf"

    • -r | --range : 頁數範圍

      支援負數索引 (如 -1 代表最後一頁)。若 from 頁數比 to 頁數後面，表示倒序。

      pdfize split "input.pdf" -r 2 5 -o "output.pdf"
      pdfize split "input.pdf" -r 2 -1 -o "output.pdf"
      pdfize split "input.pdf" -r 5 2 -o "output.pdf"
      pdfize split "input.pdf" -r -2 2 -o "output.pdf"

  • merge : PDF 合併

    • -o | --output : 輸出檔案

      pdfize merge "pdfs_dir/" -o "output.pdf"

To-do Notes

• GUI

Murmuring

寫完了 Processor 和 Pbar 之後，
才意外發現它倆就是典型的 Bridge Patterns，
哇嗚，太神奇了傑克。