pdf-simple-sign/README.adoc
2024-02-04 06:35:37 +01:00

2.2 KiB
Raw Blame History

pdf-simple-sign

pdf-simple-sign is a simple PDF signer intended for documents produced by the Cairo library (≤ 1.17.4 or using PDF 1.4), GNU troff, ImageMagick, or similar.

I dont aim to extend the functionality any further. The project is fairly self-contained and it should be easy to grasp and change to suit to your needs.

Packages

Regular releases are sporadic. git master should be stable enough. You can get a package with the latest development version using Arch Linuxs AUR, or as a Nix derivation.

Documentation

See the man page for information about usage. The rest of this README will concern itself with externalities.

PkgGoDev

Building

Build dependencies: Meson, Asciidoctor, a C++11 compiler, pkg-config
Runtime dependencies: libcrypto (OpenSSL 1.1 API)

$ git clone https://git.janouch.name/p/pdf-simple-sign.git
$ cd pdf-simple-sign
$ meson builddir
$ cd builddir
$ ninja

In addition to the C++ version, also included is a native Go port, which has enhanced PDF 1.5 support:

$ go install janouch.name/pdf-simple-sign/cmd/pdf-simple-sign@master

and a crude external VFS for Midnight Commander, that may be used to extract all streams from a given PDF file:

$ GOBIN=$HOME/.local/share/mc/extfs.d \
  go install janouch.name/pdf-simple-sign/cmd/extfs-pdf@master

To enable the VFS, edit your ~/.config/mc/mc.ext.ini to contain:

[pdf]
Type=^PDF
Open=%cd %p/extfs-pdf://

Contributing and Support

Use https://git.janouch.name/p/pdf-simple-sign to report bugs, request features, or submit pull requests. git send-email is tolerated. If you want to discuss the project, feel free to join me at ircs://irc.janouch.name, channel #dev.

Bitcoin donations are accepted at: 12r5uEWEgcHC46xd64tt3hHt9EUvYYDHe9

License

This software is released under the terms of the 0BSD license, the text of which is included within the package along with the list of authors.