CardPool 1.2.3

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: cards fetched from YGOProDeck, errata history from Yugipedia. The design supports multiple TCGs — more to follow.

Originally built for the 25 Format community — come join us on Discord.

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 — winget (Windows)

winget install PiersSinclair.CardPool

To update: winget upgrade PiersSinclair.CardPool
To remove: winget uninstall PiersSinclair.CardPool

Option C — Homebrew (macOS + Linux)

brew tap piers-sinclair/cpool
brew install cpool

To update: brew upgrade cpool
To remove: brew uninstall cpool && brew untap piers-sinclair/cpool

Option D — Self-contained executable (direct download)

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 E — 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/<date>/ by default.

Only TCG-legal cards are included — cards with no known TCG release date (OCG-only, digital-only, etc.) are excluded automatically.

cpool export                                         # default: <=25 words, strip-materials, exclude pendulum link
cpool export --words 20                              # <=20 words
cpool export --strip-materials false                 # include full material text in word count
cpool export --exclude-types none                    # include all card types
cpool export --exclude-types fusion synchro xyz link # main-deck cards only
cpool export --exclude-types pendulum link flip      # also exclude Flip monsters
cpool export --errata-mode latest                    # use current text only (fast — no Yugipedia fetch)
cpool export --words -1                              # no word limit — export all cards
cpool export --since 2025-01-01                      # also generate release notes for cards eligible since this date
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

Releasing

See RELEASING.md for the full release process, including how to renew the NuGet, winget, and Homebrew secrets.

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 -- export --errata-mode latest
dotnet run --project src/CardPool.Cli -- export --since 2025-01-01
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["CardPoolExporter"]
    YGO["YgoProDeckClient\n(HTTP)"]
    YUG["YugipediaClient\n(HTTP + rate limit)"]
    CN["CardNormalizer"]
    MS["MaterialStripper\n(--strip-materials)"]
    WC["WordCounter"]
    WTP["WikitextParser\n(AngleSharp)"]
    XL["CardPoolExcelExporter\n(ClosedXML)"]
    CSV["CardPoolCsvExporter\n(CsvHelper)"]
    RNX["ReleaseNotesExcelExporter\n(--since)"]
    RNC["ReleaseNotesCsvExporter\n(--since)"]
    OUT[("output/<date>/*.xlsx\noutput/<date>/*.csv")]
    HES["HtmlErrataScraper\n(AngleSharp)"]

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

Output Columns

The main export workbook has two sheets: <=N Words (eligible cards) and >N Words (ineligible cards). When --since is provided, a separate release notes workbook is also produced containing only cards whose eligible_since date falls on or after the given date.

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.