Create a high quality printable PDF from your decklist or a list of cards you want to proxy.
-
High resolution prints
In contrast to online tools that provide this service (e.g. MTG Press), this project creates the PDF file locally. This allows to use highest resolution Scryfall scans to create a large, high-dpi PDF file without regard for bandwidth limitations. For example, the generated PDF for a complete Commander decklist has a size of about 140MB. -
Up-to-date card scans
By directly utilizing the Scryfall API, all the latest sets are automatically availble as soon as they're available on Scryfall (which is usually incredibly fast). To not overrun Scryfall with requests, this project makes use of Scryfall bulk data to reduce API calls as much as possible. As requested by Scryfall, a small delay of 100ms is added between requests. However, as most work is done with a local copy of the bulk data, this is hardly noticeable. -
Support for both text and Arena format decklists
mtg-proxiescan work with both text and Arena format decklists. The Arena format is recommended, as it allows you to keep the same prints when moving decklists between multiple tools. There are even cases (i.e. tokens) where the name alone is not sufficient to uniquely specify a card. The Arena format helps in these case, as set and collector number are unique identifiers. However, as tools often only work with one of these formats,mtg-proxiesis a flexible as possible, even supporting mixed mode. This is especially when you are making quick additions to a decklist and don't want to search for set and collector numbers. Theconvert.pytool can be used to convert decklists between the two formats. -
Sanity checks and recommender engine
mtg-proxieswarns you if you attempt to print a low-resolution scan and is able to offer alternatives. Theconvert.pytool can automatically selects the best print for each card in a decklist with high accuracy, eliminating the need to manually select good prints. -
Token support
Thetokens.pytool appends the tokens created by the cards in a decklist to it, so you don't miss one accidentally. Caveat: This only works when Scryfall has the data on associated tokens. This is the case for cards printed or reprinted since Tenth Edition. -
ManaStack and Archidekt integration Directly use ManaStack and Archidekt deck ids as input for many functions instead of local decklist files.
Decks on Archidekt must be set to public to be read.
- Clone or download this repo.
git clone https://github.com/DiddiZ/mtg-proxies.git
cd mtg-proxies- Install requirements. Requires at least Python 3.9.
# On Linux, use `python3` instead of `python`
python -m pip install -e .You can also use a virtual environment.
- (Optional) Prepare your decklist in MtG Arena format. This is not required, but recommended as it allows for more control over the process.
COUNT FULL_NAME (SET) COLLECTOR_NUMBERE.g.:
1 Alela, Artful Provocateur (ELD) 324
1 Korvold, Fae-Cursed King (ELD) 329
1 Liliana, Dreadhorde General (WAR) 97
1 Murderous Rider // Swift End (ELD) 287Or use the convert.py tool to convert a plain decklist to Arena format:
python convert.py examples/decklist_text.txt examples/decklist.txt- Create a PDF file.
python print.py examples/decklist.txt decklist.pdfExamples:
- Create separate outputs for front and back faces
python print.py examples/decklist.txt decklist_fronts.pdf --face front
python print.py examples/decklist.txt decklist_backs.pdf --face backgit pull --ff-only
python -m pip install -e .pipenv run python print.py [-h] [--dpi DPI] decklist outfile
Prepare a decklist for printing.
positional arguments:
decklist_spec path to a decklist in text/arena format, or manastack:{manastack_id}, or archidekt:{archidekt_id}
outfile output file. Supports pdf, png and jpg.
optional arguments:
-h, --help show this help message and exit
--dpi DPI dpi of output file (default: 300)
--paper WIDTHxHEIGHT paper size in inches or preconfigured format (default: a4)
--scale FLOAT scaling factor for printed cards (default: 1.0)
--border_crop PIXELS how much to crop inner borders of printed cards (default: 14)
--background COLOR background color, either by name or by hex code (e.g. black or "#ff0000", default: None)
--cropmarks, --no-cropmarks
add crop marks (default: True)
--faces {all,front,back}
which faces to print (default: all)usage: pipenv run python convert.py decklist outfile [OPTIONAL ARGUMENTS]
Convert a decklist from text format to arena format or vice-versa.
positional arguments:
decklist_spec path to a decklist in text/arena format, or manastack:{manastack_id}, or archidekt:{archidekt_id}
outfile output file
optional arguments:
-h, --help show this help message and exit
--format {arena,text}
output format (default: arena)
--clean remove all non-card linesusage: pipenv run python tokens.py decklist [OPTIONAL ARGUMENTS]
Append the tokens created by the cards in a decklist to it.
positional arguments:
decklist_spec path to a decklist in text/arena format, or manastack:{manastack_id}, or archidekt:{archidekt_id}
optional arguments:
-h, --help show this help message and exit
--format {arena,text}
output format (default: arena)Example:
python tokens.py examples/token_generators.txtusage: deck_value.py decklist [OPTIONAL ARGUMENTS]
Show deck value decomposition.
positional arguments:
decklist_spec path to a decklist in text/arena format, or manastack:{manastack_id}, or archidekt:{archidekt_id}
optional arguments:
-h, --help show this help message and exit
--lump-threshold FLOAT
lump together cards with lesser proportional valueExample:
pipenv run python deck_value.py manastack:1234536
pipenv run python deck_value.py archidekt:365563
- MTG Press for being a very handy online tool, which inspired this project.
- Scryfall for their excellent API.
React
Typescript
Django
Laravel
Facebook
Microsoft
Google
Alibaba
D3
Tencent