https://github.com/bobjr23/mtga_swapper
Edit, Swap, or Export any assets in MTG Arena (Sleeves, Card Art, Battlefield, Emotes, Pets). Unlock any card styles, including Spiderman cards
https://github.com/bobjr23/mtga_swapper
assets extract game-mod mtg-arena mtg-cards python scraper scraping spiderman swapper
Last synced: 4 months ago
JSON representation
Edit, Swap, or Export any assets in MTG Arena (Sleeves, Card Art, Battlefield, Emotes, Pets). Unlock any card styles, including Spiderman cards
- Host: GitHub
- URL: https://github.com/bobjr23/mtga_swapper
- Owner: BobJr23
- Created: 2024-02-20T15:41:12.000Z (over 2 years ago)
- Default Branch: main
- Last Pushed: 2026-02-17T15:32:26.000Z (4 months ago)
- Last Synced: 2026-02-17T20:26:57.063Z (4 months ago)
- Topics: assets, extract, game-mod, mtg-arena, mtg-cards, python, scraper, scraping, spiderman, swapper
- Language: Python
- Homepage:
- Size: 96.5 MB
- Stars: 23
- Watchers: 2
- Forks: 4
- Open Issues: 0
-
Metadata Files:
- Readme: README.md
- Changelog: changes.json
Awesome Lists containing this project
README
# MTGA Swapper 🎴🛠️
[](https://discord.gg/nt6ZdSkzdP)
Easily **edit, swap, and export assets** in *Magic: The Gathering Arena*, including:
🎨 Sleeves, 🧙♂️ Card Art, 🌄 Lands, 🧍 Avatars, 🪄 Emotes, 🐾 Pets, and more!
Unlock any card styles in the game, including parallax and speical event styles. (See table of contents section 11)
___
**Cool New Features:**
- You can mass unlock parallax styles for any number of cards with one click
- You can export your changes to a file and then load it after updates or share it for others to use.
- You can unlock any unique card style/border. See [11. Unlock card styles](#11-unlock-card-styles) for reference
- Swap entire sets art & names (Ex. Spiderman and omenpaths). Huge thanks to Bassiuz for his script [here](https://github.com/Bassiuz/MTGA-Arena-Set-Swapper)
- You can mass export cards arts with one click
___
**exe file in [releases](https://github.com/BobJr23/MTGA_Swapper/releases)**
[Nexus mods mirror](https://www.nexusmods.com/magicthegatheringarena/mods/6) (less frequently updated)
Join the discord server [here](https://discord.gg/339qjyVc8C)
___
Got questions, ideas, or want to chat? Reach out on Discord:
**`_bobjr_`**
or join the MTGA Swapper discord server linked above
---
## 📚 Table of Contents
- [🚀 Quick Start](#-quick-start)
- [⚠️ Disclaimer](#️-disclaimer)
- [🖼️ How to Use](#️-how-to-use)
- [1. Select your MTGA database file](#1-select-your-mtga-database-file)
- [2. Choose an export folder](#2-choose-an-export-folder)
- [3. Browse card directory](#3-browse-card-directory)
- [4. Edit game assets](#4-edit-game-assets)
- [5. Upscaling Art](#5-upscaling-art)
- [6. Set Aspect Ratio](#6-set-aspect-ratio)
- [7. Swap custom land art](#7-swap-custom-land-art)
- [8. Edit other assets](#8-edit-other-assets)
- [9. Import Decklists](#9-import-decklists)
- [10. Export Fonts](#10-export-fonts)
- [11. Unlock card styles](#11-unlock-card-styles)
- [12. Export your changes](#12-export-your-changes)
- [✨ Final In-Game Results](#-final-in-game-results)
- [💬 Feedback & Support](#-feedback--support)
---
## 🚀 Quick Start
# Simple Install
You can download the .exe file from releases [here](https://github.com/BobJr23/MTGA_Swapper/releases)
**OR**
# Python Method
Check if Git is installed with
```bash
git --version
```
If not,
[Install Git here](https://git-scm.com/book/en/v2/Getting-Started-Installing-Git)
1. **Install Python (Recommended: 3.11; Compatible: ≤ 3.12)**
👉 [Download Python](https://www.python.org/downloads/)
2. **(Recommended) Install [`uv`](https://github.com/astral-sh/uv) – a fast Python package and environment manager:**
- **Windows:**
```powershell
powershell -ExecutionPolicy Bypass -Command "irm https://astral.sh/uv/install.ps1 | iex"
```
- **Mac/Linux:**
```bash
curl -LsSf https://astral.sh/uv/install.sh | sh
```
3. **Clone this repository (or download and unzip the source):**
```bash
git clone https://github.com/BobJr23/MTGA_Swapper.git
```
```bash
cd MTGA_Swapper
```
4. **(Recommended) Create a Python 3.11 virtual environment with `uv`:**
```bash
uv venv --python 3.11
```
```bash
.venv\Scripts\activate
```
5. **Install required dependencies:**
```bash
uv pip install -r requirements.txt
```
> Use requirements_noupscale.txt if you don't care about upscaling the images (saves space and time)
6. **Run the application:**
```bash
uv run main.py
```
---
## ⚠️ Disclaimer
- Your opponents do not see your edits, this is only client-side
- Use at your own risk.
- This is for educational purposes only.
- I'm **not responsible** for any issues with your device or account.
- This tool may violate MTG Arena's TOS – this repo will be removed if requested.
---
## 🖼️ How to Use
### 1. Select your MTGA database file
Locate your Arena install folder and choose the appropriate `Raw_CardDatabase... .mtga` database file.
**(Default installation path is ```C:\Program Files (x86)\Wizards of the Coast```)**
or ```C:\Program Files (x86)\Steam```
or ```C:\Program Files\Epic Games```
depending on where you installed MTG Arena from
---
### 2. Choose an export folder
Pick where you want exported game assets (images) to be saved.
---
### 3. Browse card directory
Cards will appear in a list. Click one to preview the artwork and export the image with the Save button. (If art shows up as green marks, press "Next in bundle")
---
### 4. Edit game assets
After you have made edits to the card you would like, click on Change image, then select your new image file.
---
### 5. Upscaling Art
To increase image quality, press the upscale button (may take a few seconds).
It is recommended to upscale the image **before** changing the aspect ratio to achieve the highest quality.
---
### 6. Set Aspect Ratio
Click the set aspect ratio button after opening the image if you would like to export them in their proper aspect ratio.
- Note: If you would like to edit the asset in-game, don't change the aspect ratio, as Arena will change the ratio for you.
The aspect ratios are
- 11:8 for most cards
- 3:4 for planeswalkers and larger art cards (Ex. Eldrazi)
- 4:3 for battles
---
### 7. Swap custom land art
To unlock custom lands:
- Set a **normal** land (ArtSize = 0) as Swap 1
- Set a **custom** land (ArtSize = 2) as Swap 2
- Hit **Swap Arts**
---
### 8. Edit other assets
Change avatars, sleeves, and more using the same interface.
---
### 9. Import Decklists
- You can paste MTG Arena decklists or .txt files to filter certain cards you use. Make sure the Use Decklist toggle is checked after importing
### 10. Export Fonts
---
If you want to export the font files in ttf format, there is now a button in the App's main menu
---
### 11. Unlock Card Styles
See the [list of working tags](https://github.com/BobJr23/MTGA_Swapper/blob/main/tags.md)
To remove styling effects, set the tag to 0
1696804317 is the parallax style most cards have for 200-1200 gems which show the card "moving" and being borderless
---
### 12. Export Your Changes
After every game update, you may notice that your changes disappear. This is fine, just press the "Export Changes Preset" button on the main page to save your changes, and then "Load Changes Preset" to automatically make your changes.
## ✨ Final In-Game Results
Get creative – make MTGA look how *you* want!
---
## 💬 Feedback & Support
Got questions or ideas? Reach out on Discord:
**`_bobjr_`**