The open source PDF stitching software for sewists, by sewists.
Project description
PDFStitcher
PDFSticher is a utility for stitching together many PDF pages from one document into a single page. This is also called "N-Up" or page imposition. This program was created in order to convert sewing patterns into a convenient format for projecting, though it could be used to stitch together any PDF.
Since version 0.4, it is also possible to select layers for inclusion/exclusion in the final output. Additionally, line properties can be modified for each layer if the input PDF is compatible.
For up-to-date information, also check out https://www.pdfstitcher.org.
Download the latest release
- Windows (7 or 10, 64-bit)
- macOS - Intel Processor
- macOS - M1/M2 Processor
- Using pip:
pip install pdfstitcher[gui]
Requires Python between 3.8 and 3.12.- Running
pip installl pdfstitcher
without the[gui]
option will install the command line version only. Thepdfstitcher
command is installed as a command line script, while the GUI is installed as a separate script calledpdfstitcher-gui
. - To run as a Python module, use
python -m pdfstitcher.cli
orpython -m pdfstitcher.gui
- As of June 2024, there is a known issue with building the wxPython wheel on systems with GCC 14 (e.g. Fedora 40). If the installation fails, try using Python 3.11 and installing a wheel manually from https://wxpython.org/pages/downloads/index.html.
- Running
Previous versions can be found by clicking on the "releases" link to the right.
Translations:
PDFStitcher will detect system language settings and change localisation if supported. The default language can be changed in the settings menu ("Preferences" in the menu bar on macOS).
Want to contribute a translation? PDFStitcher is now on weblate!.
Features
- Stitch together pages in any order with specified number of rows/columns
- Rotate pages for stitching
- Add a margin around the final output
- Trim or overlap the edges of each page by a specified amount
- Add blank pages by including zeros in the page list (e.g. 1-5,0,6-10)
- Layers are automatically preserved if present in the source document
- Exclude layers (either deactivate or remove)
- Modify line properties (colour, thickness, style (solid, dashed, dotted))
Development Installation
Most people probably want to just use the executable links above. However, to edit the code, clone this repo and install in editable mode using the command:
$ pip install -e ".[dev,gui]"
Help!
Found a bug, or have an idea for a great new feature? Check out the Issues tab to see if it's an open issue, or submit a new one if it's not on the list.
Project details
Release history Release notifications | RSS feed
Download files
Download the file for your platform. If you're not sure which to choose, learn more about installing packages.
Source Distribution
Built Distribution
File details
Details for the file pdfstitcher-1.0.1.tar.gz
.
File metadata
- Download URL: pdfstitcher-1.0.1.tar.gz
- Upload date:
- Size: 259.3 kB
- Tags: Source
- Uploaded using Trusted Publishing? No
- Uploaded via: twine/4.0.1 CPython/3.11.9
File hashes
Algorithm | Hash digest | |
---|---|---|
SHA256 | d7f9673817769f76e6057e3a629874e1d0cd79585a1fabf29d5ecbf32b254093 |
|
MD5 | fe4982aa8a227261862374719b8b45ea |
|
BLAKE2b-256 | 49b9edf056cfba93a5823a1b3ad35057ebc26a643289bb1d69dfca4105808bf7 |
File details
Details for the file pdfstitcher-1.0.1-py3-none-any.whl
.
File metadata
- Download URL: pdfstitcher-1.0.1-py3-none-any.whl
- Upload date:
- Size: 322.4 kB
- Tags: Python 3
- Uploaded using Trusted Publishing? No
- Uploaded via: twine/4.0.1 CPython/3.11.9
File hashes
Algorithm | Hash digest | |
---|---|---|
SHA256 | 5674ffe8ee704ee4e5f49e05cee9eafc892858bd366aeef4907afdb1e8ef5124 |
|
MD5 | 7c70081e99772872708a3eab61484e21 |
|
BLAKE2b-256 | 8ea26205297b170c414e8df48a0abe9a1806a1aad91710bbe00ab466e0995e22 |