Easily edit, swap, and/or 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 for reference
- Swap entire sets art & names (Ex. Spiderman and omenpaths). Huge thanks to Bassiuz for his script here
- You can mass export cards arts with one click
- You can share your card art swaps with other people as a single .zip share pack
exe file in releases
Nexus mods mirror (less frequently updated)
Join the discord server here
Got questions, ideas, or want to chat? Reach out on Discord:
_bobjr_
or join the MTGA Swapper discord server linked above
- 🚀 Quick Start
⚠️ Disclaimer- 🖼️ How to Use
- 1. Select your MTGA database file
- 2. Choose an export folder
- 3. Browse card directory
- 4. Edit game assets
- 5. Upscaling Art
- 6. Set Aspect Ratio
- 7. Swap custom land art
- 8. Edit other assets
- 9. Import Decklists
- 10. Export Fonts
- 11. Unlock card styles
- 12. Export your changes
- 13. Share your swaps with others
- ✨ Final In-Game Results
- 💬 Feedback & Support
You can download the .exe file from releases here
OR
Check if Git is installed with
git --versionIf not, Install Git here
-
Install Python (Recommended: 3.11; Compatible: ≤ 3.12)
👉 Download Python -
(Recommended) Install
uv– a fast Python package and environment manager:-
Windows:
powershell -ExecutionPolicy Bypass -Command "irm https://astral.sh/uv/install.ps1 | iex"
-
Mac/Linux:
curl -LsSf https://astral.sh/uv/install.sh | sh
-
-
Clone this repository (or download and unzip the source):
git clone https://github.com/BobJr23/MTGA_Swapper.git
cd MTGA_Swapper -
(Recommended) Create a Python 3.11 virtual environment with
uv:uv venv --python 3.11
.venv\Scripts\activate
-
Install required dependencies:
uv pip install -r requirements.txt
Use requirements_noupscale.txt if you don't care about upscaling the images (saves space and time)
-
Run the application:
uv run main.py
- 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.
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
Pick where you want exported game assets (images) to be saved.
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")
After you have made edits to the card you would like, click on Change image, then select your new image file.
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.
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
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
Change avatars, sleeves, and more using the same interface.
- 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
See the list of working tags
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
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.
Every time you use Change image on a card, the app keeps a copy of that art in
C:\Users\<you>\.mtga_swapper\swapped_images, named after the card's ArtId.
Press Export Share Pack (.zip) to bundle that art together with your changes into one
.zip you can send to anyone. You'll be asked whether to include only the cards you
changed art for (recommended — much smaller) or all of your changes.
Whoever receives it presses Import Share Pack (.zip) and picks the file. Their game gets your art and your card changes applied to their own files. If they've already customised some of the same cards, they'll be asked once whether to overwrite.
Cards whose art hasn't been downloaded by MTG Arena yet are skipped and reported at the end — open those cards in the game once, then import again.
Already have swaps from before this feature existed? Search or filter the card list to
the cards you customised, then press Recover swapped art from backups for all cards in the
list below. It rebuilds their images from MTGA_Swapper_Backups so you can export them
without redoing the work. A backup is also written when you only change tags, so cards you
never re-arted will come back with the game's own art — look through the folder before you
export.
Only import packs from people you trust. A pack can change card names, art, and styles in
your database, and applying one replaces your own art for any card it covers. Your previous
version of a replaced card is kept in MTGA_Swapper_Backups as a .prepack.bak file if you
want it back.
Art applied by Set Swapper is not included in a share pack — send the recipient the swap file instead.
Get creative – make MTGA look how you want!
Got questions or ideas? Reach out on Discord:
_bobjr_