pdf-helper 0.1.0

A simple python script that helps with doing simple stuff with PDFs.

PDF-Helper

A simple python package that helps with doing simple stuff with PDFs.

Features

• Merge PDFs: Merge multiple PDFs into one PDF
• Split PDFs: Split a PDF into multiple PDFs, each containing a range of pages from the original PDF
• Export as image: Export designated pages from a PDF as image files
• Remove pages: Remove designated pages from a PDF
• Encrypt a PDF
• Decrypt a PDF
• Add watermark to a PDF
• Extract images from a PDF
• Extract text: Export text from a PDF file and optionally save it to a text file
• Extract links from a PDF
• Image to PDF: Export one or multiple images as a PDF file

If you want any other feature to be added, feel free to open an issue or fork the repo and make a pull request after adding your contribution.

Usage

Installation

You can install PDF-Helper via pip:

pip install pdf-helper

And run it using the command line:

pdf-helper <command> [options]

Or you can use uvx to run the package without installing it in a specific python environment:

uvx pdf-helper <command> [options]

You can also clone the repository and use uv run:

git clone https://github.com/MPCodeWriter21/PDF-Helper.git
cd PDF-Helper
uv run pdf-helper <command> [options]

Merge PDFs

Merge multiple PDFs into one PDF:

pdf-helper merge -i <input_file_1> <input_file_2>... <input_file_n> -o <output_file>

# E.g. Merge PDFs 1, 2 and 3 into a new PDF
pdf-helper merge -i 1.pdf 2.pdf 3.pdf -o new.pdf

Split PDFs

Split a PDF into multiple PDFs, each containing a range of pages:

pdf-helper split -i <input_file> -o <output_folder> -s <split_point_1>,<split_point_2>

# E.g. Split a PDF into three PDFs, one with pages 1-10, the second with pages 11-20 and
# the third with pages 21-end
pdf-helper split -i my-pdf.pdf -o my-split-pdfs -s 10,20

# E.g. Split a PDF into PDFs each containing one page
pdf-helper split -i my-pdf.pdf -o my-split-pdfs  # No need to specify split points

Export PDF pages as image files

Export PDF pages as image files:

pdf-helper to-image -i <input_file> -o <output_folder> \
        -p <page_number_1>,<page_number_2>,...,<page_number_n> -s <scale_factor>

# E.g. Export pages 1, 2, 3 and 6 from a PDF with scale factor 1
pdf-helper to-image -i 1.pdf -o images -p 1-3,6 -s 1

# E.g. Export all pages from a PDF with scale 2
pdf-helper to-image -i my-pdf.pdf -o my-images

Remove pages from a PDF

Remove pages from a PDF:

pdf-helper remove-pages -i <input_file> -o <output_file> -p <page_number_1>,<page_number_2>,...,<page_number_n>

# E.g. Remove pages 1, 2, 3 and 6 from a PDF
pdf-helper remove-pages -i 1.pdf -o new.pdf -p 1-3,6

Export text from a PDF

To extract text from a PDF file and export them to text files you can do as follows:

pdf-helper extract-text -i <input_file> -o <output_file_name>

# E.g. Extract text from a PDF named my-pdf.pdf and save it to my-text.txt
pdf-helper extract-text -i my-pdf.pdf -o my-text.txt

Export one or multiple images as a PDF file

You simply provide the script with your images, and it will create a PDF file with them:

pdf-helper image-to-pdf -i <image_1> <image_2> <image_3> ... -o <output_file>

# E.g. Take 1.png, 2.jpg, and 3.png and create a PDF named 123.pdf and override
# if already exists
pdf-helper image-to-pdf -i 1.png 2.jpg 3.png -o 123.pdf -f

About

Author: CodeWriter21

GitHub: MPCodeWriter21/PDF-Helper

Donations

Your donations are very welcome: nowpayments.io

You can also consider donating a Star to the repo.

License

This project is licensed under the MIT License.

See the LICENSE

References

• pypdfium2
• PILlow
• log21