Skip to content

Repository files navigation

Cardwright

Desktop app that turns Magic: The Gathering card images into true 1200 DPI print-ready proxies using AI upscaling on your own GPU — free, offline after setup, no upload limits.

Unlike web-based proxy builders (which embed ~300 DPI images into a "1200 DPI" PDF), Cardwright reconstructs real detail with per-card AI model selection, then builds guillotine-ready — or cutting-machine-ready — sheets with print-shop features.

Features

Upscaling

  • Real AI upscaling to 2976×4160 px (1200 DPI at 63×88 mm) on your GPU via Vulkan. No GPU? It falls back to high-quality resizing.
  • Automatic per-card model choice: paper scans, digital renders and photorealistic art each get the model that suits them, with a manual override per card.
  • Already high-res? The AI step is skipped automatically instead of bloating the file.
  • Parallel processing, retry of failed cards, status filtering.

Getting cards in

  • Type a card name and a gallery opens with every printing of it, thumbnails and all — you see what you are about to upscale before committing to it.
  • Switch source without leaving the gallery: Scryfall, Gatherer, MPC Autofill, Pokémon (TCGdex) and Yu-Gi-Oh (YGOPRODeck). MPC bleed edges are trimmed automatically; picking a Yu-Gi-Oh card switches the card size to 59×86 mm. Pokémon cards are 63×88 mm, the same as Magic.
  • Best scan picks the sharpest printing of a searched name for you, keeping the same artwork — a weak scan is exactly what upscaling magnifies.
  • Card language: fetch printings in any of the 11 languages Scryfall carries. Applies to name lookups and decklists; cards never printed in that language come back in English and are listed, rather than failing.
  • Pasting a Scryfall or Gatherer link goes straight to the queue — you already chose the printing, so nothing second-guesses it. Gatherer links use the Gatherer image, never a substitute.
  • Decklist paste: 1 Card Name (SET) 123 [matte] *F*, exact printings by set + collector number. Archidekt and Moxfield deck URLs too.
  • Tokens: optionally add every token the deck's cards make — taken from Scryfall's own data, so it's exact.
  • Import a decklist with the art coming from Gatherer instead of Scryfall, or load an MPC Autofill order .xml to get exactly the art you picked there.
  • Local files (PNG/JPG/WEBP/AVIF/…) and drag & drop.
  • Double-faced cards fetch both faces and stay paired.

Editable print preview

The preview is a workspace, not a picture — what you see is what prints.

  • Scroll through every sheet, not just the first.
  • Drag a card to reorder it anywhere in the layout.
  • Right-click a card to duplicate it, remove it from the PDF, or delete its file from the output folder.
  • Add cards… to pull more in mid-export.
  • Magnifier on hover to inspect detail at print resolution.
  • Build a PDF straight from picked files, without using the queue.
  • Print only selected sheets (e.g. 1 or 1-3,5).
  • Export presets — save and reload named configurations.

Print sheets

  • Layouts: 3×3 portrait, 4×2 landscape, 7-card Silhouette, plus 3×4 and 4×4 for the bigger sheets — A3 and Tabloid fit 16 cards.
  • Card sizes: MTG / Pokémon (63×88), Yu-Gi-Oh (59×86), mini (44×68), tarot (70×120), plus any custom size you enter in mm. Pokémon cards are the same size as Magic cards, so they work as-is.
  • Pages: A4, Letter, A3, Legal, Tabloid, A5. Lossless or JPEG PDF, split into one file per N pages.
  • Cut guides with adjustable style (cross or corner crop marks), length, thickness and offset; margin ticks; optional rounded corners.
  • Edge bleed with selectable colour, page shift for thick-stock feeding.

Cutting machines (Silhouette / Cricut)

  • Registration marks for print & cut: 3-mark standard and 4-mark CAMEO 5a patterns, with adjustable inset, arm length and thickness.
  • Marks follow Silhouette Studio's own published geometry (0.394 in inset, 0.350 in length, 0.039 in thickness), so a sheet lands on a template built in Studio.
  • Those marks reach onto the grid, so on a small page they cost card slots. On A3 or Tabloid every layout keeps every slot — including 4×4, sixteen cards a sheet — which makes them the best pairings for machine cutting. Legal keeps all nine in 3×3; on A4 use 4×2 (8) or the 7-card layout (7). If a mark would sit on a card, that slot is left empty and the card moves to the next sheet, and a live hint names the mark inset that would keep them all.
  • Guides and margin ticks never print inside a mark's clear area, and turning guides off removes all of them.
  • 7-card Silhouette layout: one vertically centred card in the left column plus a 3×2 block, clearing both left corners where a Cameo's key marks sit (clearance goes from ~5 mm to ~49 mm on Letter).

Duplex backs

  • Mirrored back pages for flip-on-long-edge printing, DFC backs paired automatically, plus a user-supplied or MPC-sourced generic back.
  • Back offset and rotation to correct duplex misalignment, and back bleed to survive drift.
  • Duplex alignment test: a two-page front/back registration sheet — print it double-sided, hold it to the light, dial in offset and rotation.

Print quality

  • Calibration sheet with 9 colour profiles to match your printer.
  • Shadow-lift test sheet — rescues dark details crushed by inkjet plus matte lamination.
  • Black border deepening for scans whose border prints as dark grey, in two flavours: Contrast edges (the default) pushes the dark pixels inside a fixed band at the card's edge, so nothing has to guess where the border is; Auto-detect measures the frame and snaps it to black. Both take a per-card override, and you choose which sources get treated at all — MPC art already carries a true black edge, so it is left alone by default.
  • Output sharpening. All of it is applied at PDF time — your PNG masters stay untouched.

Install (Windows)

  1. Download the latest release from Releases — the installer (Cardwright_Setup-x.y.z.exe, per-user, no admin) or the portable Cardwright.exe.
  2. Run it. On first launch it downloads the AI engine and models (one time) from their official sources and detects your GPU.
  3. The app updates itself from within.

Something misbehaving? The Log button in the header opens a log file with the full details of any failure — attach it to a bug report.

Run from source

pip install -r requirements.txt
python main.py

Licence

Cardwright is free to use but it is not open source. The code is published so anyone can read and audit what the app does — you are welcome to study it, build it for your own use, and send bug reports or pull requests. You may not redistribute it, publish a modified or rebranded version, or sell it. See LICENSE.

Legal

  • This is an unofficial Fan Content project, not affiliated with or endorsed by Wizards of the Coast. It ships no Wizards assets; card images are fetched at the user's request from public APIs.
  • Card data and images courtesy of Scryfall; this app is not affiliated with Scryfall.
  • Yu-Gi-Oh card data and images courtesy of YGOPRODeck; this app is not affiliated with them. Images are downloaded once to your machine rather than hotlinked, per their API terms.
  • Pokémon card data and images courtesy of TCGdex; this app is not affiliated with them. Images are downloaded to your machine rather than hotlinked.
  • AI engine: Real-ESRGAN (BSD-3). Community models UltraSharp (Kim2091) and High Fidelity are fetched from the Upscayl project and carry non-commercial licenses.
  • Registration-mark geometry follows the spec used by silhouette-card-maker (MIT); the 7-card arrangement matches the "SevenCard" template from ProxySheet (GPL-3.0). No code from either project is used — only the published geometry.
  • The contrast-edges border treatment is a reimplementation of the approach used by Proxxied (MIT). Their code is GLSL; this is an independent numpy implementation.
  • Intended for personal playtesting. You are responsible for how you use the output.

Support

Free for the community. If Cardwright saves you time, donations help keep it maintained:

Donate

About

No description, website, or topics provided.

Resources

Stars

9 stars

Watchers

0 watching

Forks

Releases

Packages

Contributors

Languages