Getting Started

1. Register for an account here.
2. Enable detailed logging with MTG Arena:
   1. Click the "Options" gear (top right)
   2. Click "View Account" (bottom left)
   3. Check "Detailed Logs (Plugin Support)"
   4. Restart MTG Arena
3. Install the client that will upload your logs:

   Windows

   Download and run setup.exe from the Github page

   • Windows Defender or your antivirus software may initially prevent installation or running. Simply click "More Info", "Run Anyway", etc. to allow it to continue.
   • If needed, you may also be prompted to install the ".NET Framework". This Microsoft software is needed for the application to run.
   • From time to time, the software will prompt you to download updates, and you may need to go through similar steps again.
   • If you minimize the application, it will hide in your system tray (usually on the bottom right) but continue to run in the background. You can double click on the icon to open the app and see that it's making progress.

   If run into any issues, please check out the "Troubleshooting" section below.

   Mac

   The 17Lands client can be installed with Homebrew. To do so, you'll need to open your terminal program and enter a couple of commands.Note that 17Lands will not work if you are running 17Lands through Nvidia GeForce.

   • If you haven't used Homebrew before, you can install it by running the following command at the terminal:

     /bin/bash -c "$(curl -fsSL https://raw.githubusercontent.com/Homebrew/install/HEAD/install.sh)"

   • You can now use Homebrew to install the 17Lands client by running the following command at the terminal:

     brew install rconroy293/seventeenlands/seventeenlands

   • Lastly, we recommend using Homebrew to set the 17Lands client to run in the background. This will set it to always check for new data to upload from your Arena logs. Enter the following:

     brew services start rconroy293/seventeenlands/seventeenlands

     If you'd prefer not to have it always running in the background, you can start it manually each time, though note you'll need to be sure this is running whenever Arena is running, otherwise your data will be lost when Arena restarts. The command to start it manually is:

     seventeenlands

   • We may periodically ask you to update the client for bugfixes and new features. Doing so is as simple as running the following in the terminal:

     brew update && brew upgrade seventeenlands && brew services stop seventeenlands && brew services start seventeenlands

   • If for some reason you want to permanently stop 17Lands from running in the background, you can do so with:

     brew services stop seventeenlands

   If you are unable to use Homebrew for whatever reason, you may also install the Python package directly following the instructions under "Linux" below.

   If run into any issues, please check out the "Troubleshooting" section below.

   Linux

   The 17Lands client is available as a package for Python3. It is installable with pip.

   • Install the package using pip:

     pip3 install --user seventeenlands

   • Once installed, you can run it with the following command in a terminal:

     seventeenlands

   • If for some reason this shortcut command doesn't work, you can also use the more verbose version:

     python3 -m seventeenlands.mtga_follower

   • The first time you run the client (with either command above), it will ask you for your token and then exit. Simply re-run the same command to have it start tracking.
   • We may periodically ask you to update the client for bugfixes and new features. Doing so is as simple as running the following in the terminal:

     pip3 install --user --upgrade seventeenlands

4. Upon first running the program, you may be prompted to locate your MTGA log file and client token
   • Your token is on your account page
   • On Windows, the log file is usually at C:/users/{username}/AppData/LocalLow/Wizards Of The Coast/MTGA/Player.log. If you can't find the log file, try pasting the following into the file browser: %userprofile%\appdata\locallow\Wizards Of The Coast\MTGA as highlighted in pink here:
   • On Mac, you could see a message like this, about "seventeenlands" being started at login and/or being able to run in background:
   • On Linux, if you used Steam to install Arena, you will need to manually pick the log location, that should usually be ~/.steam/steam/steamapps/compatdata/2141910/pfx/drive_c/users/steamuser/AppData/LocalLow/Wizards Of The Coast/MTGA/Player.log or ~/.local/share/Steam/steamapps/compatdata/2141910/pfx/drive_c/users/steamuser/AppData/LocalLow/Wizards Of The Coast/MTGA/Player.log, unless you selected a custom location for Steam, in that case adjust the path accordingly
   After making any changes, you may need to click the "Start Parsing" button to start the tracking if you're on Windows.
5. Visit your user page after you've played to see your aggregated drafts. Any new information you've logged should be reflected within 10 minutes.

Troubleshooting

People occasionally run into errors when trying to get 17Lands set up. See if your error is listed here, and if not, check out the FAQ for other ways to try to get some help.

Uninstallation Instructions

If you would like to uninstall the 17Lands client, follow the instructions below for your operating system.