pdf-nupper 0.1.2

A command-line tool for n-upping PDF files (e.g., combining 2 pages into one) for printing purposes.

pdf-nupper

pdf-nupper is a Python command-line tool for merging multiple pages of a PDF into a single page.This is also called 'n-up' (hence the name). This is particularly useful for printing purposes, where you might want to fit multiple pages onto one sheet of paper. For example, in a lecture note where each page is a slide, you can use pdf-nupper to fit 4 pages in one sheet.

Usage

pdf-nupper input.pdf output.pdf [-l] [-n LAYOUT]

Arguments:

• input.pdf: Path to the input PDF file
• output.pdf: Path where the output PDF file will be saved

Options:

• -l, --landscape: Use landscape mode instead of portrait mode
• -n LAYOUT, --layout LAYOUT: Layout of the pages (e.g., 2x2, 3x4). Default is "1x2"

Examples:

1. Basic usage (default 1x2 layout in portrait mode):

   pdf-nupper input.pdf output.pdf
   

2. Using landscape mode:

   pdf-nupper input.pdf output.pdf -l
   

3. Custom layout (2x2 in portrait mode):

   pdf-nupper input.pdf output.pdf -n 2x2
   

4. Custom layout in landscape mode:

   pdf-nupper input.pdf output.pdf -l -n 2x4
   

Note: The layout should be specified as "NxM" where N and M are positive integers representing the number of rows and columns respectively.