Pokemon TCG Pocket Builder

A deck building tool for Pokemon TCG Pocket that allows you to build, manage, and analyze your decks.

Features

• Card Database: Browse and search through Pokemon TCG Pocket cards
• Deck Builder: Build and save multiple decks
• Card Scraper: Scrape card data from Serebii.net
• Set Management: Organize cards by sets (Shining Revelry, Genetic Apex, etc.)
• TUI Interface: Easy-to-use terminal user interface

Installation

# Clone the repository
git clone https://github.com/neeeee/ptcgpbuilder.git
cd ptcgpbuilder

# Install the package
pip install -e .

Usage

Running the Application

# Run the main application
python src/main.py

Building a Deck

In the Builder view, filter by set, type, card category, or search by name. Press "o" (the o key) on a highlighted card to bring up a deck builder popup. Add 1 or 2 copies to an existing deck or create a new deck. If the deck contains 2 copies of that card, another cannot be added.

Scraping Card Data

# Scrape a specific set
python src/scrape_pokemon_cards.py --url https://www.serebii.net/tcgpocket/shiningrevelry/

# Scrape multiple sets
python src/scrape_all_sets.py --sets shiningrevelry geneticapex

# Scrape all supported sets
python src/scrape_all_sets.py

Note: Some data may come back malformed in the json. Manual validating is necessary if something is wrong when searching the card DB.

Importing Cards to Database

# Import cards from JSON file
python src/utils/import_cards.py --input pokemon_cards_shiningrevelry.json

Keyboard Controls

• 1: Show Decks view
• 2: Show Builder view
• o: Open card actions menu (when card is highlighted)
• q: Quit application

Deck View

• Ctrl+n: Create a new deck
• Ctrl+r: Rename selected deck
• Ctrl+d: Delete selected deck
• Ctrl+y: Remove card from deck
• Ctrl+e: Export deck list

Known Issues

• Creating a new deck doesn't refresh the deck list. Switch tabs to refresh
• New deck creation has no notification popup
• Scrollable items continue after the last visible item in Builder View
• Status bar shows name of highlighted item even when not in view
• Navigation is all keyboard except a few buttons

Development

# Install development dependencies
pip install -e ".[dev]"

# Run tests
pytest

Everything Pokemon is owned by The Pokemon Company, Creatures, Nintendo, DeNA and any other related parties.

I do not own any data scraped from any sources used by this project. If Serebii would like scraping to cease, please let me know.

License

MIT License