# Cardimpose
Cardimpose is a Python library that makes it easy to arrange multiple copies of a PDF on a larger document, perfect for scenarios like printing business cards. The library lets you customize your layout while adding crop marks and comes with a handy command line tool.
## Examples
Click the images to view the corresponding pdf file.
### Business Cards
<details>
<summary>Show Example</summary>
Lets say you have a buisness card named `card.pdf`:
[<img src="https://github.com/frsche/cardimpose/blob/main/images/card.jpg?raw=true">](https://github.com/frsche/cardimpose/blob/main/examples/card.pdf?raw=true)
With the `cardimpose` command line tool, it is easy to print multiple copies of this card onto a larger sheet while adding crop marks:
`$ cardimpose card.pdf`
By default, the cards a placed side by side on an A4 sheet, filling up the entire document:
[<img src="https://github.com/frsche/cardimpose/blob/main/images/example1.jpg?raw=true">](https://github.com/frsche/cardimpose/blob/main/examples/example1.pdf?raw=true)
However, it is possible to tweak the layout.
In the following example, we add a 5mm gap between the cards:
`$ cardimpose --gutter 5mm card.pdf`
[<img src="https://github.com/frsche/cardimpose/blob/main/images/example2.jpg?raw=true">](https://github.com/frsche/cardimpose/blob/main/examples/example2.pdf?raw=true)
The example card actually has a 3mm bleed around the edges.
When informing `cardimpose`, it positions the cut marks accordingly:
`$ cardimpose --gutter 5mm --bleed 3mm card.pdf`
[<img src="https://github.com/frsche/cardimpose/blob/main/images/example3.jpg?raw=true">](https://github.com/frsche/cardimpose/blob/main/examples/example3.pdf?raw=true)
It is also possible to explicitly set the number of rows and columns:
`$ cardimpose --gutter 30mmx20mm --bleed 3mm --nup 2x2 --rotate-page card.pdf`
[<img src="https://github.com/frsche/cardimpose/blob/main/images/example4.jpg?raw=true">](https://github.com/frsche/cardimpose/blob/main/examples/example4.pdf?raw=true)
Customize the paper size, remove inner cut marks, and more:
`$ cardimpose --gutter 5mm --bleed 3mm --page-size A3 --rotate-page --no-inner-cut-marks card.pdf`
[<img src="https://github.com/frsche/cardimpose/blob/main/images/example5.jpg?raw=true">](https://github.com/frsche/cardimpose/blob/main/examples/example5.pdf?raw=true)
</details>
### Flash Cards
<details>
<summary>Show Example</summary>
In the first example, we showcased the capability of printing multiple duplicates of a single card onto a larger sheet.
In this example, we explore a scenario where we aim to produce [flash cards](https://github.com/frsche/cardimpose/blob/main/examples/flash_cards.pdf?raw=true), each featuring distinct questions and answers, to print one of each pair.
Furthermore, we desire to have the answer printed on the back of the corresponding question.
To achieve the single printing of each card, we utilize the option `--mode singles`.
To implement the printing of answers on the back, we specify `--backside alternating`.
With this configuration, each card in the input document is immediately followed by the back of the corresponding card.
For the flashcards, we would run the following command:
`$ cardimpose --gutter 5mm --bleed 3mm --mode singles --backside alternating flash_cards.pdf`
Executing this command results in the following output document:
[<img src="https://raw.githubusercontent.com/frsche/cardimpose/main/images/example6-0.jpg" width="200" />](https://github.com/frsche/cardimpose/blob/main/examples/example6.pdf?raw=true)
[<img src="https://raw.githubusercontent.com/frsche/cardimpose/main/images/example6-1.jpg" width="200" />](https://github.com/frsche/cardimpose/blob/main/examples/example6.pdf?raw=true)
Note that the backsides are horizontally flipped to ensure proper alignment when printing them double-sided.
</details>
### Playing Cards
<details>
<summary>Show Example</summary>
For the last example, we want to print [playing cards](https://github.com/frsche/cardimpose/blob/main/examples/playing_cards.pdf?raw=true).
All these cards share a common back design.
Therefore, we employ the `--backside last-page` option, treating the final page in the input PDF as the backside of all cards.
Suppose we intend to print three distinct playing cards labeled A, B and C.
For some reason, we wish to print card A three times, while cards B and C are to be printed only twice each.
To achieve this, we utilize the `--mode singles` option to not print a whole output sheet for each card, and then specify the quantities using the `--pages 3x1,2x2,2x3,4` argument.
With this configuration, we produce three copies of the first page (A), two copies of the second page (B), and two copies of the third page (C), and then the backside on page 4.
`$ cardimpose --gutter 5mm --bleed 3mm --mode singles --backside last-page --pages 3x1,2x2,2x3,4 playing_cards.pdf`
[<img src="https://raw.githubusercontent.com/frsche/cardimpose/main/images/example7-0.jpg" width="200" />](https://github.com/frsche/cardimpose/blob/main/examples/example7.pdf?raw=true)
[<img src="https://raw.githubusercontent.com/frsche/cardimpose/main/images/example7-1.jpg" width="200" />](https://github.com/frsche/cardimpose/blob/main/examples/example7.pdf?raw=true)
[<img src="https://raw.githubusercontent.com/frsche/cardimpose/main/images/example7-2.jpg" width="200" />](https://github.com/frsche/cardimpose/blob/main/examples/example7.pdf?raw=true)
[<img src="https://raw.githubusercontent.com/frsche/cardimpose/main/images/example7-3.jpg" width="200" />](https://github.com/frsche/cardimpose/blob/main/examples/example7.pdf?raw=true)
</details>
## Installation
Install `cardimpose` using pip:
```bash
pip install cardimpose
```
## Settings
### Specifying Pages
Cardimpose generates one complete output page per selected input page.
By default, every input page is selected.
To control which input pages produce outputs, use the `--pages` argument.
This argument supports various options:
- Use `.` to include all pages.
- Specify single page numbers. Negative page numbers are calculated from the back of the document.
- Define page ranges using hyphens: `1-4` = pages 1, 2, 3 and 4.
- Print a single page multiple times: `5x1` = 5 times the first page
- Combine multiple page selections with commas.
For instance, using the command `--pages 1,4-6` will impose pages 1,4,5 and 6 of the input document, generating one imposed output page for each selected input page.
Other command line options apply to all input pages.
To specify different bleeds, margins and gutters for different pages, split the input file into different pdf files and impose them separately.
### Specifying Lengths
Lengths are given by a number with a unit.
Currently, supported units are `mm`, `cm`, `in` and `px`.
The arguments `--margin` and `--gutter` can also receive separate horizontal and vertical lengths, combined by an `x`.
Setting `--margin 1cmx2cm`, sets the left and right margin to 1cm and the top and bottom margin to 2cm.
A single length for these arguments sets both directions to the same value.
### Crop Marks
By default cut marks are inserted around each imposed card.
The distance, length and thickness can be set through command line arguments (see `cardimpose --help`).
Additionally, it is possible to completely disable cutmarks or to hide the cutmarks in the middle of the imposed cards.
## Library
All features of the command line tool are also available through the `CardImpose` class.
```python
from cardimpose import CardImpose
CardImpose("card.pdf") \
.set_bleed("3mm") \
.set_gutter("5mm") \
.fill_page() \
.save("out.pdf")
```
Raw data
{
"_id": null,
"home_page": "https://github.com/frsche/cardimpose",
"name": "cardimpose",
"maintainer": null,
"docs_url": null,
"requires_python": null,
"maintainer_email": null,
"keywords": "imposition, print, pdf",
"author": "Frederik Scheerer",
"author_email": null,
"download_url": "https://files.pythonhosted.org/packages/93/24/1b94b962e152c4adf45c57f9f1839ca267f2fe78b5382c52bc1371d30b11/cardimpose-0.2.2.tar.gz",
"platform": null,
"description": "# Cardimpose\n\nCardimpose is a Python library that makes it easy to arrange multiple copies of a PDF on a larger document, perfect for scenarios like printing business cards. The library lets you customize your layout while adding crop marks and comes with a handy command line tool.\n\n## Examples\n\nClick the images to view the corresponding pdf file.\n\n### Business Cards\n\n<details>\n<summary>Show Example</summary>\n\nLets say you have a buisness card named `card.pdf`:\n\n[<img src=\"https://github.com/frsche/cardimpose/blob/main/images/card.jpg?raw=true\">](https://github.com/frsche/cardimpose/blob/main/examples/card.pdf?raw=true)\n\nWith the `cardimpose` command line tool, it is easy to print multiple copies of this card onto a larger sheet while adding crop marks:\n\n`$ cardimpose card.pdf`\n\nBy default, the cards a placed side by side on an A4 sheet, filling up the entire document:\n\n[<img src=\"https://github.com/frsche/cardimpose/blob/main/images/example1.jpg?raw=true\">](https://github.com/frsche/cardimpose/blob/main/examples/example1.pdf?raw=true)\n\nHowever, it is possible to tweak the layout.\nIn the following example, we add a 5mm gap between the cards:\n\n`$ cardimpose --gutter 5mm card.pdf`\n\n[<img src=\"https://github.com/frsche/cardimpose/blob/main/images/example2.jpg?raw=true\">](https://github.com/frsche/cardimpose/blob/main/examples/example2.pdf?raw=true)\n\nThe example card actually has a 3mm bleed around the edges.\nWhen informing `cardimpose`, it positions the cut marks accordingly:\n\n`$ cardimpose --gutter 5mm --bleed 3mm card.pdf`\n\n[<img src=\"https://github.com/frsche/cardimpose/blob/main/images/example3.jpg?raw=true\">](https://github.com/frsche/cardimpose/blob/main/examples/example3.pdf?raw=true)\n\nIt is also possible to explicitly set the number of rows and columns:\n\n`$ cardimpose --gutter 30mmx20mm --bleed 3mm --nup 2x2 --rotate-page card.pdf`\n\n[<img src=\"https://github.com/frsche/cardimpose/blob/main/images/example4.jpg?raw=true\">](https://github.com/frsche/cardimpose/blob/main/examples/example4.pdf?raw=true)\n\nCustomize the paper size, remove inner cut marks, and more:\n\n`$ cardimpose --gutter 5mm --bleed 3mm --page-size A3 --rotate-page --no-inner-cut-marks card.pdf`\n\n[<img src=\"https://github.com/frsche/cardimpose/blob/main/images/example5.jpg?raw=true\">](https://github.com/frsche/cardimpose/blob/main/examples/example5.pdf?raw=true)\n\n</details>\n\n### Flash Cards\n<details>\n<summary>Show Example</summary>\n\nIn the first example, we showcased the capability of printing multiple duplicates of a single card onto a larger sheet.\nIn this example, we explore a scenario where we aim to produce [flash cards](https://github.com/frsche/cardimpose/blob/main/examples/flash_cards.pdf?raw=true), each featuring distinct questions and answers, to print one of each pair.\nFurthermore, we desire to have the answer printed on the back of the corresponding question.\n\nTo achieve the single printing of each card, we utilize the option `--mode singles`.\nTo implement the printing of answers on the back, we specify `--backside alternating`.\nWith this configuration, each card in the input document is immediately followed by the back of the corresponding card.\n\nFor the flashcards, we would run the following command:\n\n`$ cardimpose --gutter 5mm --bleed 3mm --mode singles --backside alternating flash_cards.pdf`\n\nExecuting this command results in the following output document:\n\n[<img src=\"https://raw.githubusercontent.com/frsche/cardimpose/main/images/example6-0.jpg\" width=\"200\" />](https://github.com/frsche/cardimpose/blob/main/examples/example6.pdf?raw=true)\n[<img src=\"https://raw.githubusercontent.com/frsche/cardimpose/main/images/example6-1.jpg\" width=\"200\" />](https://github.com/frsche/cardimpose/blob/main/examples/example6.pdf?raw=true)\n\nNote that the backsides are horizontally flipped to ensure proper alignment when printing them double-sided.\n</details>\n\n### Playing Cards\n\n<details>\n<summary>Show Example</summary>\n\nFor the last example, we want to print [playing cards](https://github.com/frsche/cardimpose/blob/main/examples/playing_cards.pdf?raw=true).\nAll these cards share a common back design.\nTherefore, we employ the `--backside last-page` option, treating the final page in the input PDF as the backside of all cards.\n\nSuppose we intend to print three distinct playing cards labeled A, B and C.\nFor some reason, we wish to print card A three times, while cards B and C are to be printed only twice each.\nTo achieve this, we utilize the `--mode singles` option to not print a whole output sheet for each card, and then specify the quantities using the `--pages 3x1,2x2,2x3,4` argument.\nWith this configuration, we produce three copies of the first page (A), two copies of the second page (B), and two copies of the third page (C), and then the backside on page 4.\n\n`$ cardimpose --gutter 5mm --bleed 3mm --mode singles --backside last-page --pages 3x1,2x2,2x3,4 playing_cards.pdf`\n\n[<img src=\"https://raw.githubusercontent.com/frsche/cardimpose/main/images/example7-0.jpg\" width=\"200\" />](https://github.com/frsche/cardimpose/blob/main/examples/example7.pdf?raw=true)\n[<img src=\"https://raw.githubusercontent.com/frsche/cardimpose/main/images/example7-1.jpg\" width=\"200\" />](https://github.com/frsche/cardimpose/blob/main/examples/example7.pdf?raw=true)\n[<img src=\"https://raw.githubusercontent.com/frsche/cardimpose/main/images/example7-2.jpg\" width=\"200\" />](https://github.com/frsche/cardimpose/blob/main/examples/example7.pdf?raw=true)\n[<img src=\"https://raw.githubusercontent.com/frsche/cardimpose/main/images/example7-3.jpg\" width=\"200\" />](https://github.com/frsche/cardimpose/blob/main/examples/example7.pdf?raw=true)\n\n</details>\n\n## Installation\n\nInstall `cardimpose` using pip:\n\n```bash\npip install cardimpose\n```\n\n## Settings\n\n### Specifying Pages\n\nCardimpose generates one complete output page per selected input page.\nBy default, every input page is selected.\nTo control which input pages produce outputs, use the `--pages` argument.\n\nThis argument supports various options:\n- Use `.` to include all pages.\n- Specify single page numbers. Negative page numbers are calculated from the back of the document.\n- Define page ranges using hyphens: `1-4` = pages 1, 2, 3 and 4.\n- Print a single page multiple times: `5x1` = 5 times the first page\n- Combine multiple page selections with commas.\n\nFor instance, using the command `--pages 1,4-6` will impose pages 1,4,5 and 6 of the input document, generating one imposed output page for each selected input page.\n\nOther command line options apply to all input pages.\nTo specify different bleeds, margins and gutters for different pages, split the input file into different pdf files and impose them separately.\n\n### Specifying Lengths\n\nLengths are given by a number with a unit.\nCurrently, supported units are `mm`, `cm`, `in` and `px`.\nThe arguments `--margin` and `--gutter` can also receive separate horizontal and vertical lengths, combined by an `x`.\nSetting `--margin 1cmx2cm`, sets the left and right margin to 1cm and the top and bottom margin to 2cm.\nA single length for these arguments sets both directions to the same value.\n\n### Crop Marks\n\nBy default cut marks are inserted around each imposed card.\nThe distance, length and thickness can be set through command line arguments (see `cardimpose --help`).\nAdditionally, it is possible to completely disable cutmarks or to hide the cutmarks in the middle of the imposed cards.\n\n## Library\n\nAll features of the command line tool are also available through the `CardImpose` class.\n\n```python\nfrom cardimpose import CardImpose\n\nCardImpose(\"card.pdf\") \\\n\t.set_bleed(\"3mm\") \\\n\t.set_gutter(\"5mm\") \\\n\t.fill_page() \\\n\t.save(\"out.pdf\")\n```\n",
"bugtrack_url": null,
"license": null,
"summary": "Impose multiple copies of a pdf onto a larger document.",
"version": "0.2.2",
"project_urls": {
"Homepage": "https://github.com/frsche/cardimpose"
},
"split_keywords": [
"imposition",
" print",
" pdf"
],
"urls": [
{
"comment_text": null,
"digests": {
"blake2b_256": "a8186a52d636648741eda6f9783e31683256f6ba3f0e7aafbfdad9e7aab115da",
"md5": "29760de59fb340dbc65b852f5fbd7f00",
"sha256": "cb6d09b2d5a3bbaac392f8643c97b2c4b0fae5dfa52a8fadf72e0f4c67ad733b"
},
"downloads": -1,
"filename": "cardimpose-0.2.2-py3-none-any.whl",
"has_sig": false,
"md5_digest": "29760de59fb340dbc65b852f5fbd7f00",
"packagetype": "bdist_wheel",
"python_version": "py3",
"requires_python": null,
"size": 26334,
"upload_time": "2025-09-10T06:23:37",
"upload_time_iso_8601": "2025-09-10T06:23:37.755805Z",
"url": "https://files.pythonhosted.org/packages/a8/18/6a52d636648741eda6f9783e31683256f6ba3f0e7aafbfdad9e7aab115da/cardimpose-0.2.2-py3-none-any.whl",
"yanked": false,
"yanked_reason": null
},
{
"comment_text": null,
"digests": {
"blake2b_256": "93241b94b962e152c4adf45c57f9f1839ca267f2fe78b5382c52bc1371d30b11",
"md5": "5bf106adae9bee5f57c88d24f5011b4b",
"sha256": "7cc2366efb0719853b9d9f4275a52d59090d8f632284c11c042572f156c4e85d"
},
"downloads": -1,
"filename": "cardimpose-0.2.2.tar.gz",
"has_sig": false,
"md5_digest": "5bf106adae9bee5f57c88d24f5011b4b",
"packagetype": "sdist",
"python_version": "source",
"requires_python": null,
"size": 26255,
"upload_time": "2025-09-10T06:23:38",
"upload_time_iso_8601": "2025-09-10T06:23:38.676510Z",
"url": "https://files.pythonhosted.org/packages/93/24/1b94b962e152c4adf45c57f9f1839ca267f2fe78b5382c52bc1371d30b11/cardimpose-0.2.2.tar.gz",
"yanked": false,
"yanked_reason": null
}
],
"upload_time": "2025-09-10 06:23:38",
"github": true,
"gitlab": false,
"bitbucket": false,
"codeberg": false,
"github_user": "frsche",
"github_project": "cardimpose",
"travis_ci": false,
"coveralls": false,
"github_actions": false,
"lcname": "cardimpose"
}
JSON
