{"id":37663256,"url":"https://github.com/bobjr23/mtga_swapper","last_synced_at":"2026-02-18T18:01:06.100Z","repository":{"id":223520820,"uuid":"760533095","full_name":"BobJr23/MTGA_Swapper","owner":"BobJr23","description":"Edit, Swap, or Export any assets in MTG Arena (Sleeves, Card Art, Battlefield, Emotes, Pets). Unlock any card styles, including Spiderman cards","archived":false,"fork":false,"pushed_at":"2026-02-17T15:32:26.000Z","size":101183,"stargazers_count":23,"open_issues_count":0,"forks_count":4,"subscribers_count":2,"default_branch":"main","last_synced_at":"2026-02-17T20:26:57.063Z","etag":null,"topics":["assets","extract","game-mod","mtg-arena","mtg-cards","python","scraper","scraping","spiderman","swapper"],"latest_commit_sha":null,"homepage":"","language":"Python","has_issues":true,"has_wiki":null,"has_pages":null,"mirror_url":null,"source_name":null,"license":null,"status":null,"scm":"git","pull_requests_enabled":true,"icon_url":"https://github.com/BobJr23.png","metadata":{"files":{"readme":"README.md","changelog":"changes.json","contributing":null,"funding":null,"license":null,"code_of_conduct":null,"threat_model":null,"audit":null,"citation":null,"codeowners":null,"security":null,"support":null,"governance":null,"roadmap":null,"authors":null,"dei":null,"publiccode":null,"codemeta":null,"zenodo":null,"notice":null,"maintainers":null,"copyright":null,"agents":null,"dco":null,"cla":null}},"created_at":"2024-02-20T15:41:12.000Z","updated_at":"2026-02-17T15:32:19.000Z","dependencies_parsed_at":"2025-03-07T14:24:36.016Z","dependency_job_id":"ab25b5cc-0086-493c-916f-ceef5439a04c","html_url":"https://github.com/BobJr23/MTGA_Swapper","commit_stats":null,"previous_names":["bobjr23/mtga_swapper"],"tags_count":42,"template":false,"template_full_name":null,"purl":"pkg:github/BobJr23/MTGA_Swapper","repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/BobJr23%2FMTGA_Swapper","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/BobJr23%2FMTGA_Swapper/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/BobJr23%2FMTGA_Swapper/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/BobJr23%2FMTGA_Swapper/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/BobJr23","download_url":"https://codeload.github.com/BobJr23/MTGA_Swapper/tar.gz/refs/heads/main","sbom_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/BobJr23%2FMTGA_Swapper/sbom","scorecard":null,"host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":286080680,"owners_count":29588776,"icon_url":"https://github.com/github.png","version":null,"created_at":"2022-05-30T11:31:42.601Z","updated_at":"2026-02-18T16:55:40.614Z","status":"ssl_error","status_checked_at":"2026-02-18T16:55:37.558Z","response_time":162,"last_error":"SSL_connect returned=1 errno=0 peeraddr=140.82.121.6:443 state=error: unexpected eof while reading","robots_txt_status":"success","robots_txt_updated_at":"2025-07-24T06:49:26.215Z","robots_txt_url":"https://github.com/robots.txt","online":false,"can_crawl_api":true,"host_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub","repositories_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories","repository_names_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repository_names","owners_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners"}},"keywords":["assets","extract","game-mod","mtg-arena","mtg-cards","python","scraper","scraping","spiderman","swapper"],"created_at":"2026-01-16T11:53:21.634Z","updated_at":"2026-02-18T18:01:06.087Z","avatar_url":"https://github.com/BobJr23.png","language":"Python","funding_links":[],"categories":[],"sub_categories":[],"readme":"# MTGA Swapper 🎴🛠️  \n\n[![Discord server invite](https://discordapp.com/api/guilds/1430192422687735820/embed.png)](https://discord.gg/nt6ZdSkzdP)\n![GitHub Release](https://img.shields.io/github/v/release/bobjr23/mtga_swapper)\n![Python Version](https://img.shields.io/pypi/pyversions/realesrgan-ncnn-py)\n![GitHub Downloads](https://img.shields.io/github/downloads/bobjr23/mtga_swapper/total)\n![GitHub Actions Workflow Status](https://img.shields.io/github/actions/workflow/status/bobjr23/mtga_swapper/main.yml)\n\nEasily **edit, swap, and export assets** in *Magic: The Gathering Arena*, including:  \n🎨 Sleeves, 🧙‍♂️ Card Art, 🌄 Lands, 🧍 Avatars, 🪄 Emotes, 🐾 Pets, and more!\n\n\nUnlock any card styles in the game, including parallax and speical event styles. (See table of contents section 11)\n___\n**Cool New Features:**\n\n- You can mass unlock parallax styles for any number of cards with one click\n- You can export your changes to a file and then load it after updates or share it for others to use.\n- You can unlock any unique card style/border. See [11. Unlock card styles](#11-unlock-card-styles) for reference\n- Swap entire sets art \u0026 names (Ex. Spiderman and omenpaths). Huge thanks to Bassiuz for his script [here](https://github.com/Bassiuz/MTGA-Arena-Set-Swapper)\n- You can mass export cards arts with one click\n___\n**exe file in [releases](https://github.com/BobJr23/MTGA_Swapper/releases)**\n\n\n[Nexus mods mirror](https://www.nexusmods.com/magicthegatheringarena/mods/6) (less frequently updated)\n\nJoin the discord server [here](https://discord.gg/339qjyVc8C)\n\n___\n\nGot questions, ideas, or want to chat? Reach out on Discord:\n\n**`_bobjr_`**\n\nor join the MTGA Swapper discord server linked above\n\n---\n\n\n## 📚 Table of Contents\n\n- [🚀 Quick Start](#-quick-start)\n- [⚠️ Disclaimer](#️-disclaimer)\n- [🖼️ How to Use](#️-how-to-use)\n  - [1. Select your MTGA database file](#1-select-your-mtga-database-file)\n  - [2. Choose an export folder](#2-choose-an-export-folder)\n  - [3. Browse card directory](#3-browse-card-directory)\n  - [4. Edit game assets](#4-edit-game-assets)\n  - [5. Upscaling Art](#5-upscaling-art)\n  - [6. Set Aspect Ratio](#6-set-aspect-ratio)\n  - [7. Swap custom land art](#7-swap-custom-land-art)\n  - [8. Edit other assets](#8-edit-other-assets)\n  - [9. Import Decklists](#9-import-decklists)\n  - [10. Export Fonts](#10-export-fonts)\n  - [11. Unlock card styles](#11-unlock-card-styles)\n  - [12. Export your changes](#12-export-your-changes)\n- [✨ Final In-Game Results](#-final-in-game-results)\n- [💬 Feedback \u0026 Support](#-feedback--support)\n\n---\n\n## 🚀 Quick Start\n\n\n# Simple Install\nYou can download the .exe file from releases [here](https://github.com/BobJr23/MTGA_Swapper/releases)\n\n\n**OR**\n\n# Python Method\n\nCheck if Git is installed with \n\n```bash\ngit --version\n```\n\nIf not,\n[Install Git here](https://git-scm.com/book/en/v2/Getting-Started-Installing-Git)\n\n\n\n1. **Install Python (Recommended: 3.11; Compatible: ≤ 3.12)**  \n   👉 [Download Python](https://www.python.org/downloads/)\n\n2. **(Recommended) Install [`uv`](https://github.com/astral-sh/uv) – a fast Python package and environment manager:**\n\n   - **Windows:**\n     ```powershell\n     powershell -ExecutionPolicy Bypass -Command \"irm https://astral.sh/uv/install.ps1 | iex\"\n     ```\n\n   - **Mac/Linux:**\n     ```bash\n     curl -LsSf https://astral.sh/uv/install.sh | sh\n     ```\n\n3. **Clone this repository (or download and unzip the source):**\n   ```bash\n   git clone https://github.com/BobJr23/MTGA_Swapper.git\n   ```\n\n   ```bash\n   cd MTGA_Swapper\n   ```\n\n4. **(Recommended) Create a Python 3.11 virtual environment with `uv`:**\n   ```bash\n   uv venv --python 3.11\n   ```\n\n   ```bash\n   .venv\\Scripts\\activate\n   ```\n\n5. **Install required dependencies:**\n   ```bash\n   uv pip install -r requirements.txt\n   ```\n\n   \u003e Use requirements_noupscale.txt if you don't care about upscaling the images (saves space and time)\n\n6. **Run the application:**\n   ```bash\n   uv run main.py\n   ```\n\n---\n\n## ⚠️ Disclaimer\n\n- Your opponents do not see your edits, this is only client-side\n- Use at your own risk.\n- This is for educational purposes only.\n- I'm **not responsible** for any issues with your device or account.  \n- This tool may violate MTG Arena's TOS – this repo will be removed if requested.\n\n---\n\n## 🖼️ How to Use\n\n### 1. Select your MTGA database file  \nLocate your Arena install folder and choose the appropriate `Raw_CardDatabase... .mtga` database file.\n\n**(Default installation path is ```C:\\Program Files (x86)\\Wizards of the Coast```)**\n\nor ```C:\\Program Files (x86)\\Steam``` \n\nor ```C:\\Program Files\\Epic Games``` \n\ndepending on where you installed MTG Arena from \n\n![Database Selection](https://github.com/BobJr23/MTGA_Swapper/assets/98911103/d76fb165-cb32-447a-a27b-70719b292c9c)\n\n\n\n---\n\n### 2. Choose an export folder  \nPick where you want exported game assets (images) to be saved.\n\n---\n\n### 3. Browse card directory\nCards 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\")\n\n![image](https://github.com/user-attachments/assets/08688897-5dad-4128-8190-149aea42a9fe)\n\n\n![image](https://github.com/user-attachments/assets/e1f971b0-30cf-471b-ba86-fbfe161f8921)\n\n\n---\n\n### 4. Edit game assets\n\nAfter you have made edits to the card you would like, click on Change image, then select your new image file.\n\n---\n\n### 5. Upscaling Art\nTo increase image quality, press the upscale button (may take a few seconds). \n\nIt is recommended to upscale the image **before** changing the aspect ratio to achieve the highest quality.\n\n\n---\n\n### 6. Set Aspect Ratio\nClick the set aspect ratio button after opening the image if you would like to export them in their proper aspect ratio. \n- 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.\n\nThe aspect ratios are \n\n- 11:8 for most cards\n- 3:4 for planeswalkers and larger art cards (Ex. Eldrazi)\n- 4:3 for battles\n\n---\n\n### 7. Swap custom land art  \nTo unlock custom lands:\n\n- Set a **normal** land (ArtSize = 0) as Swap 1\n- Set a **custom** land (ArtSize = 2) as Swap 2  \n- Hit **Swap Arts**\n\n![Swap Lands 1](https://github.com/user-attachments/assets/503891a7-a090-4992-85e1-e0e339ec8a30)\n![image](https://github.com/user-attachments/assets/a20d06ba-e38e-4be4-929c-32d15ad539ff)\n![image](https://github.com/user-attachments/assets/c5902f02-f52e-4223-ae19-67a0f92f2db3)\n\n![image](https://github.com/user-attachments/assets/201a1fc7-259e-4271-a161-5990fce60667)\n![image](https://github.com/user-attachments/assets/f0c72a34-7922-45d3-a69d-3a006bc35487)\n\n---\n\n### 8. Edit other assets  \nChange avatars, sleeves, and more using the same interface.\n\n![Avatar Editing](https://github.com/BobJr23/MTGA_Swapper/assets/98911103/53afa37a-ca57-4a84-9b24-3a91c6becc86)\n\n\n---\n\n### 9. Import Decklists \n\n- 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\n  \n![image](https://github.com/user-attachments/assets/75dbd661-48af-4eca-995a-ff0ff27d2df5)\n\n\n\n### 10. Export Fonts \n\n---\n   If you want to export the font files in ttf format, there is now a button in the App's main menu\n---\n\n### 11. Unlock Card Styles\n\n\n   \u003cimg width=\"1421\" height=\"321\" alt=\"image\" src=\"https://github.com/user-attachments/assets/f64c8163-aba0-4d6f-822c-9af798ac71fa\" /\u003e\n   \nSee the [list of working tags](https://github.com/BobJr23/MTGA_Swapper/blob/main/tags.md)\n\nTo remove styling effects, set the tag to 0\n\n1696804317 is the parallax style most cards have for 200-1200 gems which show the card \"moving\" and being borderless\n   \n---\n\n### 12. Export Your Changes\n\nAfter 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.\n\n## ✨ Final In-Game Results\n\nGet creative – make MTGA look how *you* want!\n\n![Result 1](https://github.com/BobJr23/MTGA_Swapper/assets/98911103/d72bcdec-2f6b-4804-89aa-4d42634aedcc)\n![Result 2](https://github.com/BobJr23/MTGA_Swapper/assets/98911103/8e56bd7e-c6c5-499f-a1c3-37e6702dacab)  \n![Result 4](https://github.com/BobJr23/MTGA_Swapper/assets/98911103/115e8e66-85c2-4f51-af9d-f9cb46482b8b)\n\n---\n\n## 💬 Feedback \u0026 Support\n\nGot questions or ideas? Reach out on Discord:  \n**`_bobjr_`**\n","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fbobjr23%2Fmtga_swapper","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Fbobjr23%2Fmtga_swapper","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fbobjr23%2Fmtga_swapper/lists"}