Toolvix

Toolvix is a Python library for simple file, PDF, PowerPoint, Word, and image automation. Most functions automatically discover matching files in the current working folder, so users do not need to pass input filenames.

Installation

pip install toolvix

For PowerPoint/Word to PDF conversion on Windows, Microsoft PowerPoint and Microsoft Word must be installed, and install the Windows extra:

pip install "toolvix[windows]"

Quick start

from toolvix import *

pdfMerge("final.pdf")
pdfExtract([1, 2], "extract.pdf")
pdfProtect("protected.pdf", "12345")

imageTopdf("photos.pdf")
imageResize(1920, 1080)
imageWatermark("PREETAM")
imageCompressor(1)

fileEncrypt()
fileDecrypt()

API

Parameters

PDF tools

• pdfMerge(output_file="Merged.pdf"): merges every PDF in the current folder in sorted filename order.
• pdfExtract(pages, output_file="extracted.pdf"): extracts selected 1-based page numbers from the first PDF.
• pdfProtect(output_file="protected.pdf", password="12345"): password-protects the first PDF.
• pdfToword(output_file=None): converts every PDF to DOCX. With one input PDF, output_file can set its output name.
• pdfToppt(output_file=None): converts every PDF to PPTX. With one input PDF, output_file can set its output name.
• pptTopdf(output_file=None): converts every PPTX to PDF. With one input PPTX, output_file can set its output name. Windows + Microsoft PowerPoint required.
• wordTopdf(output_file=None): converts every DOCX to PDF. With one input DOCX, output_file can set its output name. Windows + Microsoft Word required.

Image tools

• imageTopdf(output_file="photos.pdf"): combines all supported images into one PDF.
• imageResize(width=1920, height=1080): resizes all supported images without cropping; aspect ratio is preserved.
• imageWatermark(watermarkText="PREETAM", textSize=100, transparency=45, angle=25): adds centered watermark text. transparency=0 is invisible and 255 is fully opaque.
• imageCompressor(targetSizeMB=1): compresses all supported images to JPG, targeting approximately the requested size in MB.
• pdfToimage(): converts every PDF page to a PNG image.

File tools

• fileEncrypt(): asks once for a password and encrypts every non-.encrypted file in the current folder.
• fileDecrypt(): asks once for a password and decrypts every .encrypted file. Successfully decrypted files replace their .encrypted versions with the original filenames.

Output folders

Toolvix keeps generated files in separate folders such as merged pdf, converted word files, resized images, and compressed images.

Notes

• Input files are discovered from Path.cwd(). Run your script from the folder containing the files you want Toolvix to process.
• Do not store passwords or sensitive files in the working folder when using fileEncrypt().