README.md

MTG AWS IoT

A quick small project for detecting Magic the Gathering cards using Amazon's Textract service.

Requirements

• Python 3.6+
• An Amazon account - AWS free tier is enough
• AWS CLI - for setting up auth credentials
• Raspberry pi (tested on model 3B+)
• Camera Module
• A button switch - example

Steps

• Set up the Raspberry pi roughly as shown use BCM pin numbers (pinout)
• If you plan to control the pi in headless mode (e.g. VNC server), enable direct capture mode (instructions)
• Install dependencies

git clone https://github.com/nicolaskyejo/mtg_aws_iot.git
cd mtg_aws_iot/project
pip install -r requirements.txt

• Run mtg_card_recognition.py

Possible Improvements

• Use gpiozero instead of RPi.GPIO for easier setup
• Use asyncio for asynchronous features
• Use sqlite instead of a text file to save card information
• Use opencv to detect card and take a picture automatically instead of manually pushing the switch down