Download and installation instructions

MTGProxyPrinter can be installed on all platforms that have a Python interpreter using pip, the Python package installer. Currently, there is a stand-alone application bundle provided for Windows (64 Bit only) that doesn’t depend on a system-wide Python 3 installation. You can also build your own bundle, if you wish, using cx_Freeze.

Installation on Windows using the provided application bundle

Download the MSI installer for Windows from the Downloads page. Most web-browsers block the download of programs and installers by default, so you probably have to explicitly allow downloading the installer.
Run it to install the application using Windows Installer. It will place a shortcut in the Start menu.

Installation via pip for Linux, macOS (And Windows)

Install the latest release: Take the Python Wheel from the Downloads page and install it via pip (see below for more details).

On Linux, you may want to perform some preparations prior to installing the Python Wheel file, to ensure best system integration:

Preparations

Linux

• Make sure you have at least Python 3.8 installed. (Check output of python3 --version). Currently, only CPython is supported, alternative implementations like PyPy or Jython do not work because of incompatibilities with PyQt5.
• Preferably, check, if the MTGProxyPrinter dependencies are available using your package manager and install them using it, instead of relying on pip to install them from PyPI. You can check the dependencies in setup.cfg of your chosen version, listed under install_requires. If you omit this step, pip will automatically install them from PyPI, but you won’t get updates for dependencies installed this way from your distribution vendor and will most likely get worse system integration.

Debian, Ubuntu and derivatives

Install the dependencies using this command: (when using the provided wheel)
sudo apt install python3-appdirs python3-ijson python3-pint python3-pyqt5 python3-hamcrest

If you want to install from a source archive, you also need to install pyqt5-dev-tools, as that package is required when installing from the source code archive. You can uninstall the package after installing from a source archive.

Arch Linux and derivatives

Install the dependencies using this command: (when using the provided wheel)
pacman -S python-appdirs python-ijson python-pint python-pyqt5 python-pyhamcrest

Windows

• Obtain a recent Python installer from https://www.python.org/downloads/. Chose the latest stable version, or, if you use Windows 7, the latest stable release of the 3.8 line. Currently, only the linked CPython is supported, alternative implementations like PyPy or Jython do not work because of incompatibilities with PyQt5.
• Install Python for your user (not globally), and make sure to tick the box Add Python <version> to PATH to add the location of the Python installation to your PATH environment variable. Without this, applications written in Python can not be launched easily.
• If you customize the Python installation, you may un-check the Documentation, Python test suite and tcl/tk and IDLE options. Keep pip and the py launcher enabled, as these are required later.

Install latest version using pip

1. If you are on Linux, make sure that pip refers to the Python 3 version. Otherwise use pip3 the next step.
2. Note the URL of the Python Wheel from the Downloads page, or download the file to your hard disk.
3. Open a terminal/command prompt and enter pip install "<URL OR PATH TO WHEEL FILE>"
   (Replace <URL OR PATH TO WHEEL FILE> with the actual location of the wheel).
   Confirm with [Return] and wait until everything is installed.
4. On Windows, the application executable will be placed in
   C:\Users\<your_user_name>\AppData\Local\Programs\Python\Python<Python-Version>\Scripts\mtg-proxy-printer.exe
   You can create a link to it on your desktop for easier access.
   On Linux, if installed for your user only, pip will place the executable mtg-proxy-printer in ~/.local/bin/.

Install specific version using pip

This is generally not recommended. Older versions contain less features and possibly more bugs. This procedure installs from a Source archive which requires the pyrcc5, so the pyqt5-dev-tools package is required on Debian/Ubuntu

1. Choose your preferred version from the tag list. Version tags start with v, like v0.9.3.
2. The download link is http://1337net.duckdns.org:8080/MTGProxyPrinter/zip/MTGProxyPrinter.zip?r={version_tag}. Replace {version_tag} with the chosen version, e.g. http://1337net.duckdns.org:8080/MTGProxyPrinter/zip/MTGProxyPrinter.zip?r=v0.9.3
3. If you are on Linux, make sure that pip refers to the Python 3 version. Otherwise use pip3 in step 3 below.
4. Open a terminal/command prompt and enter pip install "<download_link>", substitute <download_link> with the link from step 2. For example, to install 0.9.3, use
   pip install "http://1337net.duckdns.org:8080/MTGProxyPrinter/zip/MTGProxyPrinter.zip?r=v0.9.3" Confirm with [Return] and wait until everything is installed.
5. On Windows, the application executable will be placed in
   C:\Users\<your_user_name>\AppData\Local\Programs\Python\Python<Python-Version>\Scripts\mtg-proxy-printer.exe
   You can create a link to it on your desktop for easier access.
   On Linux, if installed for your user only, pip will place the executable mtg-proxy-printer in ~/.local/bin/.