🔎 PrivatePdfConverter

⭐ - The star motivates me a lot

✒️ Description

Private PDF Converter is a secure offline tool designed to effortlessly convert PNG files stored locally into a comprehensive PDF document. With a user-friendly terminal interface, this tool prioritizes privacy by ensuring all conversion processes occur offline, eliminating any reliance on cloud services. Stay in control of your sensitive data as you seamlessly transform images into PDFs without compromising confidentiality. Future updates will introduce additional features, such as PDF splitting, to further enhance functionality (see roadmap below).

🎬 Real Life Scenario

You receive an addendum from work on paper and scan it into separate files.
You don't want to send your personal data to the cloud, nor do you want to install something big.

The solution is this CLI program - simply enter a command along with the path to the folder containing the scans, and after a moment, you'll have the combined images in a single PDF.

In three words:

✨ Small, offline, and convenient!

⚡ Install

Just type to install:

dotnet tool install --global PrivatePdfConverter

and then just run it!

ppc dir --path "D:\dir-with-images"

Example of logo command:

ppc logo --path "D:\1.pdf" --logo-path "D:\logo.png" --position "bottom-left" --scale 25 --opacity 50 --output "newpdf"

📐 Arguments

Argument	Description	Options	Optional options
`dir`	Converts all images inside a directory to a single PDF file.	`path` - path to directory	`output` - PDF output name
	See below supported file extensions.
`img`	Converts a single image to a single PDF file.	`path` - path to image	`output` - PDF output name
	See below supported file extensions.
`merge`	Merges all PDF files inside a directory into a single PDF file.	`path` - path to directory	`output` - PDF output name
`encrypt`	Encrypts PDF with a password.	`path` - path to a PDF file	`output` - PDF output name
		`password` - encryption password
`logo`	Add image (logo) as a watermark to every page of PDF.	`path` - path to a PDF file	`output` - PDF output name
		`logo-path` - path to logo image	`scale` - Specifies the scale of the image in percentage (e.g., 25 for 25%, 150 for 150%). Default value: 100.
			`opacity` - Specifies the opacity of the image in percentage (e.g., 25 for 25%, 0 for 0% - invisible) Default value: 100.
			`position` - Positions of logo. One of four values are accepted: `top-left`, `top-right`, `bottom-left`, `bottom-right`.
`ext`	Lists all valid image extensions.

For all commends, default export .pdf file name is output.pdf.

📌 Supported file extensions

Type ext argument to list all of valid image extensions:

.jpg
.jpeg
.bmp
.gif
.png
.tif
.tiff
.webp

🗺️ Features roadmap

🎯 Other

🏅 Competition 100commitow

The project is part of the competition 100 commitow.

⌨️ Development

If you want to contribute, please take a look at the Roadmap or propose your own ideas.

Please create a Pull Request with a solution if you are eager to help. Keep in mind the structure of a solution. If you are going to create a new command, make sure to do it in the Commands directory.

Local

Build and run using .NET 8.0:

dotnet build

.\PrivatePdfConverter.exe dir --path "D:\dir-with-images"

🔗 Dependencies

Based on micro-framework Cocona.

jurczewski / private-pdf-converter Goto Github PK