Hudsucker Proxy Generator

pip install hudsucker==0.2.1


Hudsucker Proxy Generator

Generate MtG proxy sheets from & other sites

hudsucker takes a text file specifying a list of MtG cards and generates a set of 3x3 PDF sheets.

Unless otherwise specified, the source images are pulled from

$ hudsucker cards.txt


# Example input file, comments and blank lines are supported

# Cards names are listed one per line, misspellings are okay
Pia Nalaar              # Inline comments are also supported
Saheeli's Artistry      # Spaces, capitals, and punctuation are fine

# For multiples of the same card, list them multiple times
Strip Mine
Strip Mine

# The page for the card can be specified

# Or the image file can be listed explicitly

# Sites other than can be specified
# A best attempt will be made to determine the card image # Black Lotus

# Image files from any site can also be listed explicitly # Ancestral Recall


Example output


pip install hudsucker

If it fails with the following error message:

ValueError: jpeg is required unless explicitly disabled using --disable-jpeg, aborting

Try installing libjpeg (or equivalent for your OS):

# on OS X with homebrew
brew install libjpeg


usage: hudsucker [-h] [-v] [-b N] [-o DIR] [-p N] [-q N] [-s URL] [-c DIR]
                 [-n] [-r]
                 FILE [FILE ...]

Hudsucker Proxy Generator - generate MtG proxy sheets

positional arguments:
  FILE                  each line of FILE should be a MtG card name, or a url

optional arguments:
  -h, --help            show this help message and exit
  -v, --verbose         print verbose details

proxy sheet options:
  -b N, --border N      border width in inches, defaults to 0.072
  -o DIR, --output DIR  output dir, defaults to current dir
  -p N, --resolution N  print resolution of output PDF, defaults to 600
  -q N, --quality N     quality to use for JPEG encoding, defaults to 95
  -s URL, --site URL    site to search for card images, defaults to

caching options:
  NOTE: Careful turning off cache, search engines may ban your IP

  -c DIR, --cache DIR   cache dir, defaults to hudsucker_cache
  -n, --no-cache        don't cache any downloaded files
  -r, --refresh         force refresh of any cached downloads


Report bugs or make pull requests on GitHub.