GameSpin

Scratching my own itch, I whipped up this janky cli script to randomly select games from your collection. It relies on Cartridges, ES-DE, and a CSV file with console games.

Example screenshot using randomly generated sample data:

NOTE: I used an LLM to generate code comments and some of the directory traversal/modification logic in this project.

The Rundown

• Picks random games from three sources:
  • PC games from GNOME Cartridges library
  • ROMs from EmulationStation-DE (EmuDeck) ROM directory structure
  • Console games from a custom CSV file
• Displays results with colorful formatting in the terminal
• Indicates games that can be played on physical hardware or mobile devices

Future Jank

• Add mobile games to the mix
• Build a script to create console_games.csv as it was hand-made for myself
• Update scripts when Cartridges changes their game finding process

Usage

Run the script with no arguments to pick 3 games from each category:

./gamespin.py

For more options, see the help:

./gamespin.py --help

Console Games CSV Format

Create a CSV file with your console games in the following format:

title,system,source
"Game Title",System,format

See console_games.csv for an example.