CardPool 1.2.0

CardPool

Disclaimer: CardPool is an independent fan project and is not affiliated with, endorsed by, or sponsored by Konami Digital Entertainment. Yu-Gi-Oh! is a trademark of Konami. Card text and artwork are the intellectual property of their respective owners.

Card data is fetched from YGOProDeck and errata history from Yugipedia. Users of this tool are responsible for complying with the terms of use of both services. Output files generated by this tool may contain copyrighted card data and should not be publicly redistributed.

Card pool analysis tool for trading card games. Fetches card data from game-specific sources, enriches it with errata history, applies word-count rules, and exports to Excel/CSV.

Current implementation: Yu-Gi-Oh! The goal is to support multiple TCGs — Yu-Gi-Oh! is the first. Cards are fetched from YGOProDeck and enriched with errata history from Yugipedia.

The core purpose: identify cards whose shortest known errata version falls within a word-count threshold (default: ≤25 words).

Installation

Option A — .NET Global Tool (recommended for developers)

Requires .NET 10 SDK.

dotnet tool install -g CardPool
cpool --help

To update: dotnet tool update -g CardPool
To remove: dotnet tool uninstall -g CardPool

Option B — Self-contained executable (no .NET required)

Download the latest zip for your platform from the Releases page:

Windows: Extract the zip, then run install.ps1 (right-click → Run with PowerShell). Open a new terminal — cpool is now on your PATH.

If PowerShell blocks the script: Set-ExecutionPolicy -Scope CurrentUser RemoteSigned

macOS / Linux: Extract the zip, then run bash install.sh. Open a new terminal — cpool is now on your PATH.

To uninstall — Windows: run uninstall.ps1; macOS/Linux: run bash uninstall.sh.

Option C — Run from source

git clone https://github.com/piers-sinclair/cardpool
dotnet run --project src/CardPool.Cli -- export

Sharing with someone without repo access

Build a platform zip and send it (recipient needs no .NET):

# Windows
dotnet publish src/CardPool.Cli -p:PublishProfile=win-x64 -o dist/win-x64

# macOS (Apple Silicon)
dotnet publish src/CardPool.Cli -p:PublishProfile=osx-arm64 -o dist/osx-arm64

# Linux
dotnet publish src/CardPool.Cli -p:PublishProfile=linux-x64 -o dist/linux-x64

Commands

cpool export

Export all card data to Excel (.xlsx) and CSV. Output files are written to ./output/ by default.

cpool export                              # default: <=25 words, no-materials, no-link, no-pendulum
cpool export --words 20                   # <=20 words
cpool export --no-materials false         # include full material text in word count
cpool export --extra-deck all             # include all Extra Deck types (including Link)
cpool export --extra-deck none            # main-deck cards only
cpool export --extra-deck fusion synchro  # Fusion + Synchro only
cpool export --no-pendulum false          # include Pendulum monsters
cpool export --words 30 --output ~/ygo    # <=30 words, custom output dir

cpool inspect

Show all errata versions for a single card with word counts, highlighting the shortest and latest versions.

cpool inspect "Raiza the Storm Monarch"
cpool inspect "Dark Magician"

Global options

cpool --help      # show available commands
cpool --version   # show installed version

Development

Requirements

• .NET 10 SDK

Run from source

dotnet run --project src/CardPool.Cli -- export
dotnet run --project src/CardPool.Cli -- export --words 25
dotnet run --project src/CardPool.Cli -- inspect "Raiza the Storm Monarch"

Tests

dotnet test tests/CardPool.Tests

Architecture

flowchart TD
    CLI["Program.cs\n(System.CommandLine)"]
    EP["ExportPipeline"]
    YGO["YgoProDeckClient\n(HTTP)"]
    YUG["YugipediaClient\n(HTTP + rate limit)"]
    CN["CardNormalizer"]
    MS["MaterialStripper\n(--no-materials)"]
    WC["WordCounter"]
    WTP["WikitextParser\n(AngleSharp)"]
    XL["ExcelExporter\n(ClosedXML)"]
    CSV["CsvExporter\n(CsvHelper)"]
    OUT[("output/*.xlsx\noutput/*.csv")]
    HES["HtmlErrataScraper\n(AngleSharp)"]

    CLI -->|export| EP
    EP --> YGO
    EP --> YUG
    YUG --> WTP
    EP --> CN
    CN --> WC
    EP -->|"--no-materials"| MS
    MS --> WC
    EP --> XL
    EP --> CSV
    XL --> OUT
    CSV --> OUT
    CLI -->|inspect| YGO
    CLI -->|inspect| YUG
    YUG -->|inspect| HES

Output Columns

The Excel workbook has two sheets: <=N Words and >N Words (where N is the threshold).

Word Counting Rules

The shortest errata is selected by fewest raw words across all errata versions; ties go to the latest version. The word count is then the card-type-adjusted count of that text.

Tech Stack

License

MIT — see LICENSE.