PDF Quirk is a utility to create PDFs from images easily and fast. The images can either be loaded from storage or directly be scanned.
It is just a little office helper tool to generate PDFs easily to share them online.
The current public release is version 0.93 which was released on June, 29th, 2020.
It is available from the Github Release Page.
The first public release of PDF Quirk has the version number 0.9 and is available from the Github Release Page.
Not many distros are packaging it PDF Quirk yet - but packages for openSUSE are available from my openSUSE Buildservice Page.
As soon as PDF Quirk improves, it will make it’s way into the repositories of distributions.
With the AppImage, PDF Quirk can be used on most Linux installations right away. Just download the file, add executable permissions, and run. How to run an AppImage
The PDF Quirk source code development branch can be cloned on the Github page.
Stable release tarballs can be found on the Github release page.
To build PDF Quirk, a Qt 5.x development setup is needed.
Unpack the source archive and go to the top directory of the source. From there, perform the following steps:
mkdir build cd build cmake -DCMAKE_INSTALL_PREFIX=/usr/local .. make make install
This will install pdfquirk to
/usr/local/bin on the computer.
On runtime, the tool
convert from ImageMagick is needed to convert to pdf. The utility
scanimage from SANE is used for scanning (optional). It is recommended to install these through the package manager of the Linux distribution.
PDF Quirk uses the command line utility
scanimage to produce images from the scanner. It comes with the SANE packages which are standard for scanners under linux.
To scan with PDF Quirk, an optimal
scanimage command for the scanner device must be found and put into the configuration. Since all the scanner devices are so different and offer different scan options, it does not make too much sense to use a default here.
To get a reasonable result for the PDF, the scan should
Also be sure to configure the right scan size. PDF Quirk assumes that a whole page is scanned.
To learn more about the SANE project and the scanimage tool, refer to the scanimage manpage for details.
If you have a better way of producing images, it is also possible to make PDF Quirk use that.
To configure PDF Quirk, open the configuration area by clicking the Configure menu item. Two editable line allow to apply a command line for monochrome and color scan.
scanimage by default sends the scanned image to standard out. PDF Quirk is prepared to that and reads it from there.
If another tool should be used to create PDF that writes its output directly to a file rather than to stdout, the commandline may contain the placeholder
%OUTFILE. If that is in the command line string, PDF Quirk will replace that by a filename the tool can write to (From version 0.91 on).s
Attention: To quote command line parameters which contain spaces only the use of single quotes is supported. Do not use double quotes, as PDF Quirks parser can not properly deal with that.
Please report wishes and bugs in the Issue Tracker.
Pull requests that change code are very welcome!