https://github.com/firkemancer/commander2tts
Simple SPA to import Moxfield MTG Commander decklists, tweak alternate card artworks and export into Tabletop Simulator compatible .JSON format
https://github.com/firkemancer/commander2tts
javascript json magic-the-gathering mtg spa tabletop-simulator
Last synced: 4 months ago
JSON representation
Simple SPA to import Moxfield MTG Commander decklists, tweak alternate card artworks and export into Tabletop Simulator compatible .JSON format
- Host: GitHub
- URL: https://github.com/firkemancer/commander2tts
- Owner: firkemancer
- Created: 2026-02-15T21:20:32.000Z (4 months ago)
- Default Branch: main
- Last Pushed: 2026-02-16T19:44:12.000Z (4 months ago)
- Last Synced: 2026-02-16T19:47:00.956Z (4 months ago)
- Topics: javascript, json, magic-the-gathering, mtg, spa, tabletop-simulator
- Language: HTML
- Homepage: https://firkemancer.github.io/commander2tts/
- Size: 504 KB
- Stars: 0
- Watchers: 0
- Forks: 0
- Open Issues: 16
-
Metadata Files:
- Readme: README.md
Awesome Lists containing this project
README
# COMMANDER2TTS - Import Moxfield MTG Commander decklists into Tabletop Simulator
Commander2TTS is a simple SPA to import Moxfield MTG Commander decklists, tweak alternate card artworks and export decks into Tabletop Simulator compatible .JSON format.
You don't need to setup anything! Just visit [Commander2TTS](https://firkemancer.github.io/commander2tts) for the latest build!
For nightly versions you'll need to host it locally, check the [Quick Start](https://github.com/firkemancer/commander2tts?tab=readme-ov-file#quick-start) guide.
## Features
- Import decks from Moxfield
- Import decks from Tabletop Simulator's Custom Object JSON file
- also compatible with JSON files exported from frogtown.me
- Manually search and add/remove cards
- Choose alternate card art
- Use custom image URLs (both alternate card art and back card art)
- Multiple deck management
- Export to Tabletop Simulator's custom object JSON format
- Local storage (no account needed)
## Quick Start
Simply clone the repository and run one of the following:
```bash
# Windows: Double-click start_server.py
# Or from command line:
python start_server.py
# Linux/Mac:
python3 start_server.py
# Linux - Bash Script:
./start_server.sh
```
The browser will open automatically to `http://localhost:8000/index.html`
### Manual Python Command
```bash
cd /path/to/folder
python -m http.server 8000 # Windows
python3 -m http.server 8000 # Linux/Mac
# Then open browser to: http://localhost:8000/index.html
```
## Why Do I Need a Server?
The HTML file needs to run on a web server (not just opened directly) because:
- **CORS restrictions**: Browsers block API requests from `file://` URLs
- **Moxfield import**: The Moxfield API import requires proper HTTP origin headers
- **Better compatibility**: Many features work better when served over HTTP
---
**Note**: Your deck data is saved in your browser's localStorage. It persists between sessions but is tied to the `localhost:8000` origin. If you change ports, you'll need to re-import your decks.