A sideproject by Delta for home arcades to add immersion.

Warning

This is a heavy WIP system. All could change in the future. As of right now, this is where the repo stands. Also, this repo (specifically websites) are AI Agent Generated. There will be a disclaimer on each generated area with "Generated by Anthropic's Claude."

This is a simple card scanner program that uses an RFID scanner that is PnP and acts like a USB keyboard.

How does it work?

The program is simple, and works like so:

1. It awaits a "." to be pressed (via a scan, as all ID's on cards start with ".")
2. It reads keyboard actions until enter is pressed via a keyboard listener (pynput).
3. It checks back with a database for the ID, and deducts credits from the user (pymongo/MongoDB).

What do I need to run this?

This should work with any PnP (Plug n Play) RFID card reader.

1. Setup a MongoDB Server (Either setup Community Edition to run locally OR setup community on a server to talk back to/setup MongoDB Atlas, all methods work just fine.)
2. Set the connection URI based on the setup you have with MongoDB
3. Setup the Database "delt_arcade" with the collections "cards" "news" "transactions" "users".
4. Run the script. If all goes well, you should be brought to the attract screen. Your console output (if you so choose) will output "Going to attract...", and you should see something like this:
   
   
5. Prepare to run the WebUI. Open the WebUI Folder and run this via python or by pip pip install fastapi uvicorn pymongo python-jose[cryptography] passlib[bcrypt] python-dotenv bcrypt==4.0.1. These are the dependecies for the webserver. (This will be cleaned up into a requirements later.)
6. set the admin via py -c "from webui import create_admin;create_admin()". This will generate you an adminstrator account.
7. run webui.py. This is a FastAPI script generated by Anthropic's Claude, which doubles as a webserver. Any content on this website has been AI Assisted by Anthropic's Claude.
8. go to localhost:8080 for the WebUI, and localhost:8080/docs for the API documentation made by FastAPI.
9. Add a card via your administrator account, and give it credits.

There's no Releases? How can I grab this?

You can do 1 of 2 things.

• For the untested version, grab the latest code via going to Code > Download ZIP, use GitHub Desktop to grab the code from the repository, or use a Git client and run git clone https://github.com/GooberDelta/Delts-DIY-Scanner/
• For the latest version pushed. Please go here to get the latest build available.

Extra Notes:

Code edits:

PLEASE READ: YOU NEED TO EDIT SOME PARTS OF THIS SCRIPT TO WORK WITH YOUR GAME OF CHOICE. AND THIS IS ONLY BUILT FOR WINDOWS. ANY OTHER VERSIONS ARE NOT OFFICIALLY SUPPORTED BY ME.

Some lines to edit:
(182) app_windows = pygetwindow.getWindowsWithTitle("Project Outfox") # REPLACE WITH YOUR GAME NAME, E.X STEPMANIA, ITGMANIA
(192) kb.press("[") # REPLACE "[" WITH YOUR INSERT CREDIT BUTTON!
(242) q1 = {"gameName": "OutFox"} # OutFox is the default set, but you can set this to something else. make it match your DB.

Hardware Tested:

I have tested this with this reader and card from Amazon. You could probably find a better one to use, but this project works great for any generic PnP (Plug N Play) RFID card reader.

• Card Reader
• Cards

Credits

Thanks to @Uzziaheart on X/Twitter for the logo!

Trello for Progress

We now have a trello for Progress on this project. I would highly recommend viewing it if you find interest in this project.
Trello for Repo