mtg-print 0.5.0

CLI tool for printing MTG proxy sheets from decklists

mtg-print

CLI tool for printing Magic: The Gathering proxy sheets. Parses decklists, fetches card images from Scryfall, and generates printable PDFs.

Installation

pipx install mtg-print

Or run directly:

uvx mtg-print --help

Quick start

mtg-print build docs/example.txt --interactive

Usage

Build a PDF from a decklist

mtg-print build deck.txt
mtg-print build deck.txt -o output.pdf
mtg-print build deck.txt --paper letter  # US Letter (saves as default)

Or import directly from Archidekt:

mtg-print build "https://archidekt.com/decks/1799965/tovolar_werewolves"

Basic lands are automatically filtered. Cards default to their oldest printing. Paper defaults to A4; use --paper letter for US Letter (preference is saved for future builds). PDFs are configured for single-sided printing at 100% scale.

Interactive art selection

mtg-print build deck.txt --interactive

Displays available printings with thumbnails and lets you choose. Selections are saved for future builds.

Override specific card art

mtg-print build deck.txt -s "Swords to Plowshares=ICE"

Include tokens and emblems

mtg-print build deck.txt --extras

Automatically includes tokens, emblems, and meld cards created by cards in your deck.

Add cutting guides

mtg-print build deck.txt --guides

Adds crop marks at card corners for easier cutting.

Search card printings

mtg-print search "Sylvan Library"
mtg-print search "Elvish Reclaimer" --preview

Manage preferences

mtg-print prefs           # View saved art preferences
mtg-print prefs --clear   # Clear all preferences

Manage cache

mtg-print cache --stats   # Show cache size
mtg-print cache --clear   # Clear cached images

Check format legality

mtg-print check deck.txt --format modern
mtg-print check deck.txt --format legacy

Validates your decklist against format banlists. Supported formats: standard, pioneer, modern, legacy, pauper, commander.

Supported decklist formats

• Moxfield / MTG Arena: 4 Elvish Reclaimer (MH2) 166
• MTGGoldfish: 4 Elvish Reclaimer <mh2>
• DeckedBuilder: 4 Elvish Reclaimer
• Manabox: 1 Card Name (SET) 123 *F*
• TopDecked: 4 Spyglass Siren

Development

git clone https://github.com/jamiemc1/mtg-print.git
cd mtg-print
uv sync --dev
uv run pytest
uv run pre-commit run --all-files

---

Card images © Wizards of the Coast