Skip to main content

CLI tool for printing MTG proxy sheets from decklists

Project description

mtg-print

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

Demo

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)

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

Project details


Download files

Download the file for your platform. If you're not sure which to choose, learn more about installing packages.

Source Distribution

mtg_print-0.4.0.tar.gz (89.8 kB view details)

Uploaded Source

Built Distribution

If you're not sure about the file name format, learn more about wheel file names.

mtg_print-0.4.0-py3-none-any.whl (14.6 kB view details)

Uploaded Python 3

File details

Details for the file mtg_print-0.4.0.tar.gz.

File metadata

  • Download URL: mtg_print-0.4.0.tar.gz
  • Upload date:
  • Size: 89.8 kB
  • Tags: Source
  • Uploaded using Trusted Publishing? No
  • Uploaded via: uv/0.9.26 {"installer":{"name":"uv","version":"0.9.26","subcommand":["publish"]},"python":null,"implementation":{"name":null,"version":null},"distro":{"name":"Ubuntu","version":"24.04","id":"noble","libc":null},"system":{"name":null,"release":null},"cpu":null,"openssl_version":null,"setuptools_version":null,"rustc_version":null,"ci":true}

File hashes

Hashes for mtg_print-0.4.0.tar.gz
Algorithm Hash digest
SHA256 0f6bcb5faf7da53fb09741dd8afd993a161c473fdb31ae639d72056df6f19995
MD5 679d458005f127aef91181d33b85dee1
BLAKE2b-256 b59008051cc56c30fe889124110a44bdeb941ca32ad9859056b4d9d8211395ca

See more details on using hashes here.

File details

Details for the file mtg_print-0.4.0-py3-none-any.whl.

File metadata

  • Download URL: mtg_print-0.4.0-py3-none-any.whl
  • Upload date:
  • Size: 14.6 kB
  • Tags: Python 3
  • Uploaded using Trusted Publishing? No
  • Uploaded via: uv/0.9.26 {"installer":{"name":"uv","version":"0.9.26","subcommand":["publish"]},"python":null,"implementation":{"name":null,"version":null},"distro":{"name":"Ubuntu","version":"24.04","id":"noble","libc":null},"system":{"name":null,"release":null},"cpu":null,"openssl_version":null,"setuptools_version":null,"rustc_version":null,"ci":true}

File hashes

Hashes for mtg_print-0.4.0-py3-none-any.whl
Algorithm Hash digest
SHA256 b540b489389099f444c2f61de639638ee9c99bdb018c95397230227dda458684
MD5 7c5551b8e8cfbbac4f0ed3b398bec5c5
BLAKE2b-256 d0c374e7df0011e979e9e800773562c8b5aa9107de0e0ceba20bc7394824ce86

See more details on using hashes here.

Supported by

AWS Cloud computing and Security Sponsor Datadog Monitoring Depot Continuous Integration Fastly CDN Google Download Analytics Pingdom Monitoring Sentry Error logging StatusPage Status page