Metadata-Version: 2.1
Name: pdf-nupper
Version: 0.1.1
Summary: A command-line tool for n-upping PDF files (e.g., combining 2 pages into one) for printing purposes.
Author-email: Thameera Senanayaka <me@thameera.com>
Project-URL: Homepage, https://github.com/thameera/pdf-nupper
Project-URL: Bug Tracker, https://github.com/thameera/pdf-nupper/issues
Keywords: PDF,n-up,combine,printing
Classifier: Programming Language :: Python :: 3
Classifier: License :: OSI Approved :: MIT License
Classifier: Operating System :: OS Independent
Requires-Python: >=3.6
Description-Content-Type: text/markdown
License-File: LICENSE
Requires-Dist: pypdf>=4.3.0

# 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.

## Usage

```bash
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):
   ```bash
   pdf-nupper input.pdf output.pdf
   ```

2. Using landscape mode:
   ```bash
   pdf-nupper input.pdf output.pdf -l
   ```

3. Custom layout (2x2 in portrait mode):
   ```bash
   pdf-nupper input.pdf output.pdf -n 2x2
   ```

4. Custom layout in landscape mode:
   ```bash
   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.
