Skip to content

Latest commit

 

History

History
61 lines (40 loc) · 2.39 KB

README.md

File metadata and controls

61 lines (40 loc) · 2.39 KB
Raw

pdf_merge

Build Status

This is a small tool for merging together pdf files.

usage: pdf_merge.py [-h] [-i PATH] [-o PATH] [-m MODULO] [--pages-csv PATH]
                    [--pages-csv-separator PAGES_CSV_SEPARATOR] [-v]

Merges together a bunch of pdf files.

optional arguments:
  -h, --help            show this help message and exit
  -i PATH, --input-path PATH
                        Read source pdfs from PATH.
  -o PATH, --output-path PATH
                        Write merged pdf to PATH. Default: './merged.pdf'.
  -m MODULO, --modulo MODULO
                        Adds pages to the end of each document to fulfil
                        (nPages % MODULO == 0) for each merged document.
  --pages-csv PATH      Write input file page counts into 'PATH.csv'. ('Do I
                        really want to include that in my file?)
  --pages-csv-separator PAGES_CSV_SEPARATOR
                        Use given CSV separator. Defaults to ';'.
  -v, --verbose         Turn on verbose output.

Why?

  • Insert blank pages for print

    I wanted to concatenate a large number of scientific publications into a single pdf ready to be printed at the copy-shop. Additionally, I want to print double-sided and/or in a n-pages-on-1-fashion while being able to afterwards separate the individual publications out again without them overlapping within on a single physical piece of paper. The --modulo MODULO argument solves this problem.

    E.g.: If you want to print 4-pages-on-1 double-sided you want to use a modulus of 4 * 2 = 8.

  • Extract page counts

    Moreover, I might want to exclude some publications from the print e.g. in case they are just an article within a book that I have as a complete pdf in my bibliography software. Using the --pages-csv argument helps to find those input files with unreasonable page counts which I then can exclude from the print.

AppImage

This tool comes with a build-script to package it up as an AppImage.

This might seem to be a little over-engineered for such a simple tool but I just wanted to take the chance to play around with this otherwise really promising technology.

$ ./AppImage/build.sh
...

Result: .../build/pdf_merge.AppImage

Success!

This script requires make and wget

License

MIT