A tool for RetroPie to scrape Godot games hosted on https://itch.io/.

This scraper uses the also open-source itch.io Godot Scraper project, which scrapes all the Godot games hosted on https://itch.io/ and creates an API that can be consumed from the following URL https://itchio-godot-scraper.now.sh/api.

cd /home/pi/
git clone https://github.com/hiulit/RetroPie-Itchio-Godot-Scraper.git
cd RetroPie-Itchio-Godot-Scraper/
sudo chmod +x setup.sh
sudo chmod +x retropie-itchio-godot-scraper.sh

cd /home/pi/RetroPie-Itchio-Godot-Scraper/
git pull

You can install the script to be launched from:

• EmulationStation's RetroPie menu
• RetroPie Setup

You can use the GUI:

./setup.sh

Or you can use the command line:

./setup.sh {--install | --uninstall} {retropie-menu | scriptmodule}

If you don't want to install the script, you can just run it from the downloaded folder.

cd /home/pi/RetroPie-Itchio-Godot-Scraper/
./retropie-itchio-godot-scraper.sh

If you installed the script in EmulationStation's RetroPie menu:

• Enter EmulationStation.
• Go to the RetroPie menu.
• Select itch.io Godot Scraper to launch the script.

If you installed the scriptmodule, first you have to set it up:

• Run sudo /home/pi/RetroPie-Setup/retropie_setup.sh.
• Select Manage packages.
• Select Manage optional packages.
• Select itchio-godot-scraper.
• Select Install from source.

Now:

• Run sudo /home/pi/RetroPie-Setup/retropie_setup.sh.
• Select Configuration / tools.
• Select itchio-godot-scraper to launch the script.

In both cases you'll end up with a simple dialog, where you can:

• Select games to scrape.
• Scrape all games.
• Delete scrapings.

This is how the default EmulationStation theme will look after the scraping.

Most likely it's because the developer didn't properly* name the game build, but maybe it's because the scrapper does a bad job at finding the games.

See the itch.io Godot Scraper project (which is the API where this scraper takes the data from) to better understand how the scraper works and maybe tell the developer to rename the game so it's scrapable by this script. Or even better, contribute to make it better 😉.

* It's actually not their fault, but the scraper needs a game to be named in some kind of convention to be able to scrape it.

This scraper takes all the data from https://itch.io/ and some games have assets (images/videos) that are licensed under various licenses. So, to be as fair as posible, the script adds some files linking to the game's source webpage. These can be located at:

• ~/RetroPie/roms/godot-engine/000_GAME_ATTRIBUTIONS_000.txt
• ~/RetroPie/roms/godot-engine/images/000_IMAGE_ATTRIBUTIONS_000.txt
• ~/RetroPie/roms/godot-engine/videos/000_VIDEO_ATTRIBUTIONS_000.txt

See CHANGELOG.

hiulit

• Twitter: @hiulit
• GitHub: @hiulit

Feel free to:

• Open an issue if you find a bug.
• Create a pull request if you have a new cool feature to add to the project.
• Start a new discussion about a feature request.

If you love this project or find it helpful, please consider supporting it through any size donations to help make it better ❤️.

If you can't, consider sharing it with the world...

... or giving it a star ⭐️.

Thank you very much!

• Source code: MIT License.