pdf-sign/README.md
2023-08-07 15:11:19 +02:00

57 Zeilen
2,3 KiB
Markdown

# pdf-sign
## What
A tool to sign PDF files, with Linux support.
We are here referring to the visible, non-cryptographic squiggles.
![](README-example.gif)
## How
First, create one or several signatures in the form of small PDF files with transparent backgrounds.
The recommended way is:
* Use the included `pdf-create-empty` tool to create an empty, transparent PDF file.
If 3×2 inch suits you, you can use [empty-3inx2in.pdf](empty-3inx2in.pdf) directly.
* Use an application of your choice to sign it.
You can for example use Okular's Freehand Line, or transfer it to your smartphone and use Adobe Acrobat Reader.
Keep in mind that it's the center of this mini-page that will be used for positioning the signature.
* Put the signed file in `~/.pdf_signatures/`.
You can now use the `pdf-sign` tool interactively (or non-interactively) to sign PDF files.
Run `pdf-sign -h` or `pdf-create-empty -h` for details.
**Installation**
* Install dependencies: `python3.7` or later with module `tkinter`, `gs` (Ghostscript), `pdftk` and `pdfinfo`.
* Copy one or both tools to a directory in your `$PATH`.
**Installation on Debian**
```sh
apt-get update
apt-get install -y coreutils git python3 python3-tk ghostscript pdftk poppler-utils
git clone https://github.com/svenssonaxel/pdf-sign.git
cd pdf-sign
cp pdf-sign pdf-create-empty /usr/local/bin/
```
## Why
There appears to be a lack of applications that run on Linux and allow for attaching free-hand signatures to PDF files in a good way.
(Non-)alternatives include:
* **Xournal and Xournal++:**
Allows free-hand annotations, but not saving those for later use.
Allows inserting images and .pdf files but will rasterize them rather than retain the vector graphics, resulting in lower quality.
* **LibreOffice Draw:**
Allows inserting images and .pdf files but will rasterize them rather than retain the vector graphics, resulting in lower quality.
* **Okular:**
Allows free-hand annotations, but not saving those for later use.
Allows inserting custom saved stamps, but these will not be visible in other PDF readers.
* **Evince:**
Allows certain kinds of annotations, but nothing that can look like a free-hand signature.
* **pdftk**, **ghostscript**, and other command-line tools:
Allows superimposing .pdf files, but not interactively selecting where.