Card Sorter

Card Sorter will eventually be a Python-based tool for organizing, searching, and managing trading card collections. It leverages image hashing, publicly available JSON data gained through apis, and database operations to help users efficiently sort, store and retrieve cards. The intention with this project is to identify all of my cards in named boxes, with only rudimetary sorting, and be able to query a database for a card name and find a/the matching box. I would love to integrate this with a IoT project where inventory can be added and put onto a shelf or in a storage that can be indicated using an led.

Learning Outcomes

1. Python OOP: Designed modular classes for card data and operations.
2. Image Processing: Used perceptual hashing to identify and sort card images.
3. Data Management: Worked with JSON sets and SQLite databases for persistent storage.
4. Utility Scripts: Built reusable utilities for parsing, database operations, and set management.
5. CLI & Automation: Automated card sorting and searching via command-line scripts.

Project Architecture

• Core Scripts:
  • app.py: Main entry point for sorting and searching cards.
  • card.py: Card class and related logic.
  • phash_main.py: Image hashing and matching logic.
• Utilities:
  • JSON parsing, database operations, and set management in util/.
• Data:
  • Card sets stored as JSON in json_sets/.
  • Database files in database/.
• Extensibility:
  • Easy to add new card sets, utilities, or database features.

Explore the Code

• Card Sorter on GitHub