Magic The Gathering Desktop Companion

Magic The Gathering Desktop Companion is an open-source Java application to manage your MTG collection, build decks, and analyze prices across multiple providers.

Highlights

• Collection and stock management (foil/etched/condition aware)
• Deck building (constructed and sealed) with import/export tools
• Price analysis dashboards and alerts
• Embedded services (web UI, JSON HTTP server, shopping/trades/collection web servers)
• Plugin-oriented architecture for providers (cards, cache, notifications, external shops, dashboards, and more)

Project links

• Website: https://www.mtgcompanion.org/
• Releases: https://github.com/nicho92/MtgDesktopCompanion/releases
• Wiki: https://github.com/nicho92/MtgDesktopCompanion/wiki
• Issues: https://github.com/nicho92/MtgDesktopCompanion/issues
• Security policy: SECURITY.md

Support

If you want to support hosting and ongoing development, see donation/support links on the website and in the release pages. MTGCompanion is developped with many contributors, and is and will remain open source. Online service ( like Discord bot, Websites) are hosted on my own server, and DNS are paid on my a personnal funds. Any help are welcome :)

Requirements

• Java 23+
• Maven 3.9+

Quick start (from source)

git clone https://github.com/nicho92/MtgDesktopCompanion.git
cd MtgDesktopCompanion
mvn -DskipTests clean install

Then launch the packaged application from:

target/executable/bin/mtg-desktop-companion.sh

(Use mtg-desktop-companion.bat on Windows.)

Build and test

mvn clean install
mvn test

Documentation

• User guide: https://github.com/nicho92/MtgDesktopCompanion/wiki
• Developer guide: https://github.com/nicho92/MtgDesktopCompanion/wiki/Developer-Guide

Repository structure

• src/main/java/org/magic/api: provider APIs and plugin implementations
• src/main/java/org/magic/services: core services (business logic, jobs, tools, networking)
• src/main/java/org/magic/servers: embedded server implementations
• src/main/java/org/magic/gui: application gui components and frames
• src/main/java/org/magic/game: simulator game components and logics
• src/test/java: unit and integration tests

Contributing

1. Fork the repository.
2. Create a feature branch.
3. Run tests locally.
4. Open a pull request with a clear description and reproduction steps (if bug fix).

Portfolio