PDF Quirk

A small utility to generate PDFs from images or scans in an easy and fast way.

This project is maintained by dragotin

PDF Quirk

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.


PDF Quirk uses the very well functioning tools convert from ImageMagick and scanimage from the SANE project instead of reinventing the wheel.

Downloads and Releases


The current public release is version 0.91. 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.


PDF Quirk is available as an automatic built AppImage. It can be downloaded from Github.

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

Building from Source

Currently, the PDF Quirk source code can be cloned on the Github page.

It needs a Qt 5.x development setup to be compiled. On runtime, it needs convert from ImageMagick and scanimage from SANE for scanning.


SANE scanimage

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

  1. have a resolution of 150 or 200 dpi.
  2. be scanned in mode Grayscale for monochrome of Color.
  3. not have a too big color depth

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.

Note that 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 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!