The open-source, local-first companion and combat analytics engine for Magic: The Gathering Arena on Linux & macOS.

📖 User Guide & Manual  •  📝 Release Changelog  •  📦 GitHub Releases

---

⚡ What is Rhystic Tracker?

Rhystic Tracker is a native, ultra-responsive desktop companion for MTG Arena on Linux and macOS. It continuously parses MTGA's Player.log in real time, persisting every match, mulligan, card draw, spell resolution, token creation, permanent destruction, and combat damage swing into a local SQLite database on your machine.

Built with Tauri v2, Rust, React 18, and TypeScript, it delivers maximum visual performance and instant zero-latency queries without cloud requirements, tracking accounts, or telemetry.

Fan Content Disclaimer: Rhystic Tracker is unofficial Fan Content permitted under the Wizards of the Coast Fan Content Policy. Portions of the materials used are property of Wizards of the Coast. © Wizards of the Coast LLC. Card artwork and symbols are fetched via Scryfall's API.

---

✨ Features at a Glance

• 🔄 Automatic True Decklist Capture & UUID Sync: Automatic ingestion of 100% full genuine decklists (including Commanders) upon starting a match or navigating decks, paired with MTGA persistent UUID tracking that automatically propagates deck modifications and renames while preserving historical match analytics.
• 🏆 Global Card Achievements & Trophy Case: 21 custom SVG achievement emblems spanning 7 categories with Bronze, Silver, and Gold tiers, objective value thresholds ($X+$), MVP showcase, center-out symmetrical square clustering, and interactive drill-down roster modal with MTG lore quotes.
• 🏛️ All-Time Leaderboards & Hall of Fame: 3×3 domain grid across Combat Damage, Non-Combat Damage, and Honors & Mastery with 9 categories (including Card Draw Engines and Battlefield Stalwarts), podium styling with crowns, full-height 25-card drill-down modal, live search, and diff-to-podium tracking.
• 🍏 Native macOS & Linux Platform Support: Universal release packaging with native log and raw card database discovery across Linux (Proton, Lutris, Bottles, Heroic) and macOS.
• 🃏 Mulligan Tracking & Timeline Replay: Full London mulligan detection, opening hand buffer state machine, and dedicated Opening Phase section in the Match Play Timeline with amber mulligan and orange bottom badges.
• 🧙‍♂️ First-Time Setup Wizard & Dynamic Discovery: Guided 3-step setup with real-time log detection across all prefixes, plus instant startup card indexing (26,000+ cards in ~150ms).
• 🏅 Comprehensive MTGA Formats Coverage: Native categorization and distinct colored badges for all 13 formats (Standard, Standard Brawl, Brawl, Alchemy, Historic, Timeless, Explorer, Draft, Sealed, Bot Match with precon resolution, Direct Challenge, Midweek Magic, and Gladiator).
• 📊 Dashboard & Time-Series Win Rate Analytics: Today's and all-time records, active streak counter, daily match grouping, and an overhauled time-series graph with 5 time windows (Today, 7 Days, 30 Days, 12 Months, All Time), dual-colored 50% threshold trend line (green/red), and volume histograms.
• ⚔️ Live Match HUD: Real-time game state tracker showing hero/opponent commanders, life swings, card plays, token creations, death/exile logs, and detailed combat/spell damage attributions with authentic MTG font icons.
• 🔍 Full Match Inspector & Turn Timeline: Responsive viewport scaling ($80\text{vw} \times 90\text{vh}$), universal Esc / backdrop dismissal, play-by-play combat replay per turn, damage magnitude badges ([4 DMG]), card types, and victory/defeat causes.
• 📈 Lifetime Card Combat Analytics: Persistent per-card metrics — win rate when cast, total damage dealt (face vs permanent splits), combat vs spell classification, MVP decks, and turn cast frequency histograms.
• 🎴 Deck Library & 3-Column Inspector: Automatic and manual True-decklist management, starter deck exclusions, responsive 3-column decklist expansion for widescreen displays, enlarged mana distribution pie chart, and centered MANA VALUE histogram pill overlay.
• 🖼️ Card Library & Real-Time Collection Sync: Visual collection explorer synced with submitted decks, dual Landscape Art Crop and Portrait Full Card modes, 4-diamond interactive ownership controls, and persistent alternate set printing selection.
• ⚙️ Settings & Storage Suite: Dynamic 2-column control panel with local image cache manager (live disk usage, purge, pre-download), database storage inspector with 1-click native DB backup export, startup tab preferences, log auto-discovery, manual card re-syncing, and wizard re-run tools.
• 🎨 Five Color-Identity Mana Themes: Dynamic White, Blue, Black, Red, and Green themes that meticulously tint the entire application.

---

📸 Screenshots Showcase

Dashboard	Live Match HUD

Match History & Match Inspector	Turn Playback & Combat Timeline

Deck Library & True Decklist Inspector	Card Library & Combat Analytics

---

🚀 Quick Start & Installation

Option 1: One-Line Installer (Recommended)

Run the automated installer in your terminal. It automatically fetches the latest release, installs the binary, registers the application icon, and sets up your desktop launcher:

curl -sSL https://raw.githubusercontent.com/Balthazzahr/Rhystic-Tracker/main/install.sh | bash

(Alternatively using wget: wget -qO- https://raw.githubusercontent.com/Balthazzahr/Rhystic-Tracker/main/install.sh | bash)

The installer copies the binary to ~/.local/bin/rhystic-tracker, registers high-resolution application icons into ~/.local/share/icons/, and creates the desktop entry so Rhystic Tracker appears immediately in your application launcher (GNOME, Pop Launcher, Cosmic, Rofi, Wofi, KDE Plasma).

Note: install.sh automatically sets GDK_BACKEND=x11 in the desktop launcher so the app works correctly on both X11 and Wayland sessions (via XWayland).

Option 2: Manual Download from GitHub Releases

• Linux (x86_64):

  1. Download rhystic-tracker-linux-x86_64.tar.gz from GitHub Releases.
  2. Extract and run ./install.sh:

     tar -xzf rhystic-tracker-linux-x86_64.tar.gz
     ./install.sh

• macOS (Universal - Apple Silicon & Intel):

  1. Download rhystic-tracker-macos-universal.dmg from GitHub Releases.
  2. Open the .dmg and drag Rhystic Tracker to your Applications folder.
  3. First launch Gatekeeper bypass: Right-click (or Control-click) Rhystic Tracker in Applications, select Open, and confirm Open.

---

Option 3: Build from Source

If you prefer to compile from source or clone the repository:

1. Install System Dependencies

Rhystic Tracker uses Tauri v2, which requires WebKitGTK and standard GTK3 build libraries on Linux.

Debian / Ubuntu / Pop!_OS / Linux Mint:

sudo apt update
sudo apt install -y libwebkit2gtk-4.1-dev libgtk-3-dev libayatana-appindicator3-dev librsvg2-dev build-essential curl wget file libssl-dev libjavascriptcoregtk-4.1-dev nodejs npm

Arch Linux / Omarchy / Manjaro:

sudo pacman -S --needed webkit2gtk-4.1 base-devel curl wget openssl appmenu-gtk-module libappindicator-gtk3 librsvg nodejs npm

Fedora / RHEL:

sudo dnf install -y webkit2gtk4.1-devel gtk3-devel libappindicator-gtk3-devel librsvg2-devel openssl-devel @development-tools nodejs npm

macOS:

xcode-select --install

2. Install Node.js & Rust (if not already installed)

• Node.js (v18+)
• Rust: curl --proto '=https' --tlsv1.2 -sSf https://sh.rustup.rs | sh

3. Clone, Build, and Install

# Clone the repository
git clone https://github.com/Balthazzahr/Rhystic-Tracker.git
cd Rhystic-Tracker

# Install dependencies and build self-contained release app
npm install
npm run build:app

# Run installer to place binary and desktop shortcuts
./install.sh

---

📦 Runtime Dependencies (For Pre-built Binaries)

If running the pre-built release binary on a minimal or newly installed Linux system, ensure the WebKitGTK 4.1 runtime is present:

• Pop!_OS / Ubuntu / Debian: sudo apt install libwebkit2gtk-4.1-0 libayatana-appindicator3-1
• Arch Linux: sudo pacman -S webkit2gtk-4.1 libappindicator-gtk3
• Fedora: sudo dnf install webkit2gtk4.1 libappindicator-gtk3

---

🖥️ Wayland / Steam Deck Note

Rhystic Tracker requires X11 or XWayland. The desktop launcher installed by install.sh automatically sets GDK_BACKEND=x11, so it works on both X11 and Wayland sessions out of the box. If you launch the binary directly from a terminal on a Wayland-only session, prepend the env var:

GDK_BACKEND=x11 rhystic-tracker

---

🗑️ Uninstall

rm ~/.local/bin/rhystic-tracker \
   ~/.local/share/applications/rhystic-tracker.desktop \
   ~/.local/share/icons/hicolor/512x512/apps/rhystic-tracker.png

Your match data in ~/.config/rhystic-tracker/rhystic.db is preserved and can be backed up or deleted separately.

---

📄 License

This project is licensed under the MIT License.