pdf-nupper


Namepdf-nupper JSON
Version 0.1.2 PyPI version JSON
download
home_pageNone
SummaryA command-line tool for n-upping PDF files (e.g., combining 2 pages into one) for printing purposes.
upload_time2024-09-03 11:17:25
maintainerNone
docs_urlNone
authorNone
requires_python>=3.6
licenseNone
keywords pdf n-up combine printing
VCS
bugtrack_url
requirements No requirements were recorded.
Travis-CI No Travis.
coveralls test coverage No coveralls.
            # pdf-nupper

[![PyPI](https://img.shields.io/pypi/v/pdf-nupper?label=pypi%20package&color=blue)](https://pypi.org/project/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

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

            

Raw data

            {
    "_id": null,
    "home_page": null,
    "name": "pdf-nupper",
    "maintainer": null,
    "docs_url": null,
    "requires_python": ">=3.6",
    "maintainer_email": null,
    "keywords": "PDF, n-up, combine, printing",
    "author": null,
    "author_email": "Thameera Senanayaka <me@thameera.com>",
    "download_url": "https://files.pythonhosted.org/packages/96/c2/b8c924b29094c703660d853bb158f4728d9b3842aad50d779c63558e2bbe/pdf_nupper-0.1.2.tar.gz",
    "platform": null,
    "description": "# pdf-nupper\n\n[![PyPI](https://img.shields.io/pypi/v/pdf-nupper?label=pypi%20package&color=blue)](https://pypi.org/project/pdf-nupper/)\n\n`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.\n\n## Usage\n\n```bash\npdf-nupper input.pdf output.pdf [-l] [-n LAYOUT]\n```\n\n### Arguments:\n\n- `input.pdf`: Path to the input PDF file\n- `output.pdf`: Path where the output PDF file will be saved\n\n### Options:\n\n- `-l, --landscape`: Use landscape mode instead of portrait mode\n- `-n LAYOUT, --layout LAYOUT`: Layout of the pages (e.g., 2x2, 3x4). Default is \"1x2\"\n\n## Examples:\n\n1. Basic usage (default 1x2 layout in portrait mode):\n   ```bash\n   pdf-nupper input.pdf output.pdf\n   ```\n\n2. Using landscape mode:\n   ```bash\n   pdf-nupper input.pdf output.pdf -l\n   ```\n\n3. Custom layout (2x2 in portrait mode):\n   ```bash\n   pdf-nupper input.pdf output.pdf -n 2x2\n   ```\n\n4. Custom layout in landscape mode:\n   ```bash\n   pdf-nupper input.pdf output.pdf -l -n 2x4\n   ```\n\nNote: The layout should be specified as \"NxM\" where N and M are positive integers representing the number of rows and columns respectively.\n",
    "bugtrack_url": null,
    "license": null,
    "summary": "A command-line tool for n-upping PDF files (e.g., combining 2 pages into one) for printing purposes.",
    "version": "0.1.2",
    "project_urls": {
        "Bug Tracker": "https://github.com/thameera/pdf-nupper/issues",
        "Homepage": "https://github.com/thameera/pdf-nupper"
    },
    "split_keywords": [
        "pdf",
        " n-up",
        " combine",
        " printing"
    ],
    "urls": [
        {
            "comment_text": "",
            "digests": {
                "blake2b_256": "5ce280724212bc8e7f3a27de177f6d3eed69d31c0f7ff6f21c191deb46efc24c",
                "md5": "5b172e8d93fffcd17825b01e9b2f70a5",
                "sha256": "ee7673dd1d91a01ebe135fd596507e30bf48b9079f49322de2b69fe61b9256db"
            },
            "downloads": -1,
            "filename": "pdf_nupper-0.1.2-py3-none-any.whl",
            "has_sig": false,
            "md5_digest": "5b172e8d93fffcd17825b01e9b2f70a5",
            "packagetype": "bdist_wheel",
            "python_version": "py3",
            "requires_python": ">=3.6",
            "size": 4617,
            "upload_time": "2024-09-03T11:17:24",
            "upload_time_iso_8601": "2024-09-03T11:17:24.170114Z",
            "url": "https://files.pythonhosted.org/packages/5c/e2/80724212bc8e7f3a27de177f6d3eed69d31c0f7ff6f21c191deb46efc24c/pdf_nupper-0.1.2-py3-none-any.whl",
            "yanked": false,
            "yanked_reason": null
        },
        {
            "comment_text": "",
            "digests": {
                "blake2b_256": "96c2b8c924b29094c703660d853bb158f4728d9b3842aad50d779c63558e2bbe",
                "md5": "7c1e7424de04fc398d25e0dd60ef27f5",
                "sha256": "6c92409871cd563a870f83c3e2f1b91aed7abd3c94f8efffe19c2ca0e81f75dd"
            },
            "downloads": -1,
            "filename": "pdf_nupper-0.1.2.tar.gz",
            "has_sig": false,
            "md5_digest": "7c1e7424de04fc398d25e0dd60ef27f5",
            "packagetype": "sdist",
            "python_version": "source",
            "requires_python": ">=3.6",
            "size": 3940,
            "upload_time": "2024-09-03T11:17:25",
            "upload_time_iso_8601": "2024-09-03T11:17:25.630519Z",
            "url": "https://files.pythonhosted.org/packages/96/c2/b8c924b29094c703660d853bb158f4728d9b3842aad50d779c63558e2bbe/pdf_nupper-0.1.2.tar.gz",
            "yanked": false,
            "yanked_reason": null
        }
    ],
    "upload_time": "2024-09-03 11:17:25",
    "github": true,
    "gitlab": false,
    "bitbucket": false,
    "codeberg": false,
    "github_user": "thameera",
    "github_project": "pdf-nupper",
    "travis_ci": false,
    "coveralls": false,
    "github_actions": true,
    "lcname": "pdf-nupper"
}
        
Elapsed time: 3.80734s