{"id":13526329,"url":"https://github.com/hiulit/RetroPie-Godot-Engine-Emulator","last_synced_at":"2025-04-01T07:32:01.006Z","repository":{"id":41364076,"uuid":"177624283","full_name":"hiulit/RetroPie-Godot-Engine-Emulator","owner":"hiulit","description":"A scriptmodule to install a Godot \"emulator\" for RetroPie.","archived":false,"fork":false,"pushed_at":"2023-07-09T13:57:35.000Z","size":1211,"stargazers_count":91,"open_issues_count":4,"forks_count":15,"subscribers_count":6,"default_branch":"master","last_synced_at":"2024-10-30T00:17:00.409Z","etag":null,"topics":["emulator","frt","godot-emulator","godot-engine","godot-games","raspberry-pi","retropie","scriptmodule","shell-script","x86","x86-64"],"latest_commit_sha":null,"homepage":"","language":"Shell","has_issues":true,"has_wiki":null,"has_pages":null,"mirror_url":null,"source_name":null,"license":"mit","status":null,"scm":"git","pull_requests_enabled":true,"icon_url":"https://github.com/hiulit.png","metadata":{"files":{"readme":"README.md","changelog":"CHANGELOG.md","contributing":null,"funding":".github/FUNDING.yml","license":"LICENSE","code_of_conduct":null,"threat_model":null,"audit":null,"citation":null,"codeowners":null,"security":null,"support":null,"governance":null,"roadmap":null,"authors":null,"dei":null,"publiccode":null,"codemeta":null},"funding":{"patreon":"hiulit","ko_fi":"hiulit","custom":"https://www.paypal.me/hiulit"}},"created_at":"2019-03-25T16:29:32.000Z","updated_at":"2024-08-02T17:01:06.000Z","dependencies_parsed_at":"2024-06-12T22:29:55.839Z","dependency_job_id":"83b7ae24-0119-4cc4-b3b5-365b6344ec92","html_url":"https://github.com/hiulit/RetroPie-Godot-Engine-Emulator","commit_stats":null,"previous_names":["hiulit/retropie-godot-game-engine-emulator"],"tags_count":26,"template":false,"template_full_name":null,"repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/hiulit%2FRetroPie-Godot-Engine-Emulator","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/hiulit%2FRetroPie-Godot-Engine-Emulator/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/hiulit%2FRetroPie-Godot-Engine-Emulator/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/hiulit%2FRetroPie-Godot-Engine-Emulator/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/hiulit","download_url":"https://codeload.github.com/hiulit/RetroPie-Godot-Engine-Emulator/tar.gz/refs/heads/master","host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":246600763,"owners_count":20803478,"icon_url":"https://github.com/github.png","version":null,"created_at":"2022-05-30T11:31:42.601Z","updated_at":"2022-07-04T15:15:14.044Z","host_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub","repositories_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories","repository_names_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repository_names","owners_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners"}},"keywords":["emulator","frt","godot-emulator","godot-engine","godot-games","raspberry-pi","retropie","scriptmodule","shell-script","x86","x86-64"],"created_at":"2024-08-01T06:01:28.133Z","updated_at":"2025-04-01T07:32:00.236Z","avatar_url":"https://github.com/hiulit.png","language":"Shell","funding_links":["https://patreon.com/hiulit","https://ko-fi.com/hiulit","https://www.paypal.me/hiulit","https://www.patreon.com/hiulit","https://ko-fi.com/F2F7136ND","https://www.buymeacoffee.com/hiulit","https://www.paypal.com/paypalme/hiulit"],"categories":["Other"],"sub_categories":["3D"],"readme":"# RetroPie Godot Engine \"Emulator\"\n\n![GitHub release (latest by date)](https://img.shields.io/github/v/release/hiulit/RetroPie-Godot-Game-Engine-Emulator?style=flat-square) ![GitHub license](https://img.shields.io/github/license/hiulit/cross-compile-godot-raspberry-pi?style=flat-square)\n\nA scriptmodule to install a Godot \"emulator\" for RetroPie.\n\n![Retropie-Godot-Banner](example-images/retropie-godot-banner.jpg)\n\nThanks to [@efornara](https://github.com/efornara) (for creating [FRT - A Godot \"platform\" targeting single board computers](https://github.com/efornara/frt)) you can now play 2D games made with the [Godot Engine](https://godotengine.org/) on the Raspberry Pi (and other single-board computers) using [RetroPie](https://retropie.org.uk/).\n\nIf you are running RetroPie on an `x86/x86_64` Linux PC you can also play Godot games, since the Godot \"emulator\" is actually the official **Linux/X11** export template.\n\n## Table of contents\n\n- [Where to find games made with Godot](#-where-to-find-games-made-with-godot)\n- [Compatibility list](#%EF%B8%8F-compatibility-list)\n- [Setup script](#%EF%B8%8F-setup-script)\n- [Install the Godot \"emulator\" from RetroPie-Setup](#install-the-godot-emulator-from-retropie-setup)\n- [Uninstall the Godot \"emulator\" from RetroPie-Setup](#uninstall-the-godot-emulator-from-retropie-setup)\n- [Update the Godot \"emulator\" from RetroPie-Setup](#update-the-godot-emulator-from-retropie-setup)\n- [How to install Godot games](#how-to-install-godot-games)\n- [Using a GPIO/Virtual keyboard](#using-a-gpiovirtual-keyboard)\n- [Troubleshooting](#ℹ%EF%B8%8F-troubleshooting)\n- [How to create a new Godot system for an EmulationStation theme](#-how-to-create-a-new-godot-system-for-an-emulationstation-theme)\n- [Pre-made Godot systems](#-pre-made-godot-systems)\n\n## 🎮 Where to find games made with Godot\n\nThere are plenty of games made with Godot, most of them hosted on https://itch.io.\n\nYou can find Godot games using the following links:\n\n- https://itch.io/games/made-with-godot\n- https://itch.io/games/tag-godot\n\nMost games are free to dowload, some are \"pay what you want\" with a suggested price (including free) and a few are paid. If you like the game, consider supporting the authors 😊.\n\n## ✔️ Compatibility list\n\nTake a look at the [compatibility list](https://docs.google.com/spreadsheets/d/1ybU_NHqhnJmZnlP9YDDGEf4BJ5nInbfsVVQtQCM7rYw/edit?usp=sharing) to check which games work.\n\nEveryone can contribute to the list by starting a [discussion](https://github.com/hiulit/RetroPie-Godot-Game-Engine-Emulator/discussions).\n\n## 🛠️ Setup script\n\n### Install the script\n\n```\ncd ~\ngit clone https://github.com/hiulit/RetroPie-Godot-Game-Engine-Emulator.git\ncd RetroPie-Godot-Game-Engine-Emulator/\nsudo chmod +x setup-godot-engine-scriptmodule.sh\n```\n\n### Update the script\n\n```\ncd ~/RetroPie-Godot-Game-Engine-Emulator/\ngit pull\n```\n\n## 🚀 Usage\n\n```\n./setup-godot-engine-scriptmodule.sh [OPTIONS]\n```\n\nIf no options are passed, you will be prompted with a usage example:\n\n```\nUSAGE: ./setup-godot-engine-scriptmodule.sh [OPTIONS]\n\nUse '--help' to see all the options.\n```\n\nThe script assumes that you are running it on a Raspberry Pi with the `RetroPie-Setup` folder being stored in `~/RetroPie-Setup`. If your setup differs, you can pass the path where your `RetroPie-Setup` folder is stored as a parameter, like this:\n\n```\n./setup-godot-engine-scriptmodule.sh [OPTION] \"/path/to/your/RetroPie-Setup\"\n```\n\n## 📖 Options\n\n- `--help`: Prints the help message and exit.\n- `--version`: Shows the script version.\n- `--install [path]`: Installs the `godot-engine` scriptmodule.\n  - Path: The location of the `RetroPie-Setup` folder.\n  - Default: `~/RetroPie-Setup`.\n- `--uninstall [path]`: Uninstalls the `godot-engine` scriptmodule.\n  - Path: The location of the `RetroPie-Setup` folder.\n  - Default: `~/RetroPie-Setup`.\n- `--update [path]`: Updates the `godot-engine` scriptmodule.\n  - Path: The location of the `RetroPie-Setup` folder.\n  - Default: `~/RetroPie-Setup`.\n\n## Install the Godot \"emulator\" from RetroPie-Setup\n\nOnce you've successfully installed the scriptmodule, run:\n\n```\nsudo ~/RetroPie-Setup/retropie_setup.sh\n```\n\nGo to:\n\n- Manage packages\n- Manage optional packages\n- godot-engine\n- Install from source\n\nThe script installs all the major versions of Godot for maximum compatibility:\n\n- `2.1.6`\n- `3.0.6`\n- `3.4.5`\n- `3.5.1`\n\nA new `godot-engine` folder will be created in `~/RetroPie/roms`, where you can [install the Godot games](#how-to-install-godot-games) using the `.pck` and `.zip` extensions.\n\n## Uninstall the Godot \"emulator\" from RetroPie-Setup\n\nRun:\n\n```\nsudo ~/RetroPie-Setup/retropie_setup.sh\n```\n\nGo to:\n\n- Manage packages\n- Manage optional packages\n- godot-engine\n- Remove\n\n## Update the Godot \"emulator\" from RetroPie-Setup\n\nBefore updating the \"emulator\", you must update the **setup script** and the **scriptmodule**.\n\nRun:\n\n```\n# Update the setup script.\ncd ~/RetroPie-Godot-Game-Engine-Emulator/\ngit pull\n# Update the scriptmodule.\n./setup-godot-engine-scriptmodule.sh --update\n```\n\nThen, to update the Godot \"emulator\", run:\n\n```\nsudo ~/RetroPie-Setup/retropie_setup.sh\n```\n\nGo to:\n\n- Manage packages\n- Manage optional packages\n- godot-engine\n- Update from source\n\n## How to install Godot games\n\nWhen you download a game from https://itch.io, the downloaded `.zip` usually contains 2 files:\n\n- The Godot executable.\n- The game data.\n\nThe later is, most of the times, a `.pck` file. That's the one we want!\n\nThose `.pck` files will most likely be found on the **Linux downloads** (maybe on the **Windows downloads** too).\n\nIf you can't find a `.pck` file on neither the Linux nor the Windows downloads, you can try the **Mac/OSX downloads**. You'll have to:\n\n- Unzip the `.zip` file.\n- Go to `Contents -\u003e Resources` (the `.pck` file should be in this folder).\n\nTo install it, just copy the `.pck` file to `~/RetroPie/roms/godot-engine`.\n\n## Scraping games\n\nA scraper for games hosted on https://itch.io is bundled with this script.\n\nCheck out its [documentation](https://github.com/hiulit/RetroPie-Itchio-Godot-Scraper).\n\nYou can find it in EmulationStation's RetroPie menu.\n\n![EmulationStation RetroPie menu](example-images/emulationstation-retropie-menu.png)\n\n## Using a GPIO/Virtual keyboard\n\n\u003e ⚠️ When using a GPIO/Virtual keyboard, the actual keyboard won't work anymore. But you can always remove the GPIO/Virtual keyboard (see below).\n\nAs of **v1.2.0**, when using the **FRT** \"emulator\", you can use a GPIO/Virtual keyboard, such as [GPIOnext](https://github.com/mholgatem/GPIOnext) or [Adafruit's Retrogame](https://github.com/adafruit/Adafruit-Retrogame).\n\n### Add/Remove a GPIO/Virtual keyboard\n\nRun:\n\n```\nsudo ~/RetroPie-Setup/retropie_setup.sh\n```\n\nand then go to:\n\n- Configuration/tools\n- godot-engine\n\nSelect **GPIO/Virtual keyboard**.\n\n![GPIO/Virtual keyboard dialog](example-images/gpio-virtual-keyboard-dialog.png)\n\nYou will be prompted with a menu showing all the results from the command `cat /proc/bus/input/devices`. Select the GPIO/Virtual keyboard that you want.\n\nIf you want to to reverse that action, follow the same steps and select **None**.\n \n## ℹ️ Troubleshooting\n\n### A game doesn't launch or crashes\n\n\u003e Useful information about errors can be found at `/dev/shm/runcommand.log`.\n\nIf the game you are trying to play doesn't work, it will most likely be because it was made with another version of Godot. Try changing the Godot \"emulator\" version in the [runcommand](https://github.com/RetroPie/RetroPie-Setup/wiki/runcommand).\n\nIf you downloaded the game from https://itch.io, there's a good chance the author stated which version of Godot that game uses.\n\nIn case none of the \"emulators\" work, it could be something related to the video driver.\n\n### Video issues\n\nSee [VIDEO ISSUES](docs/VIDEO_ISSUES.md).\n\n### Audio issues\n\nSee [AUDIO ISSUES](docs/AUDIO_ISSUES.md).\n\n\n## 🎨 How to create a new Godot system for an EmulationStation theme\n\nAs there is no way to create a script to automate this, because themes don't have the same structure, the best way is to manually create a new system in your preferred theme.\n\n- [Download](https://raw.githubusercontent.com/hiulit/RetroPie-Godot-Game-Engine-Emulator/master/art/system.svg) the Godot `system.svg`.\n- [Download](https://raw.githubusercontent.com/hiulit/RetroPie-Godot-Game-Engine-Emulator/master/art/controller.svg) the Godot `controller.svg`.\n- Copy any system folder in your theme (e.g. `/etc/emulationstation/themes/[THEME]/nes`).\n- Rename it as `godot-engine`.\n- Move the Godot `system.svg` and `controller.svg` to the `godot-engine/art` folder.\n\n**NOTE**:\n\nThe folder structure in the theme you are using might differ. Take a look at how this particular theme works to create the `godot-engine` folder accordingly. You might need to delete extra icons that are not needed.\n\n## 🤖 Pre-made Godot systems\n\nI've created a couple of ready-to-use Godot systems:\n\n- For the **Carbon theme**, which is the default EmulationStation theme that comes with RetroPie.\n- For the **Pixel theme**, my personal favourite theme.\n\nIf you want to add a new theme, feel free to open a [pull request](https://github.com/hiulit/cross-compile-godot-raspberry-pi/pulls).\n\n\u003e The default EmulationStation theme is installed automaticaly and can't be deleted.\n\nTo install a Godot system, copy the `theme/[THEME]/godot-engine` folder from this repository to `/etc/emulationstation/themes/[THEME]`.\n\nOr you can run:\n\n```\nsudo ~/RetroPie-Setup/retropie_setup.sh\n```\n\nand then go to:\n\n- Configuration/tools\n- godot-engine\n\nSelect **Install themes**.\n\n![Install themes dialog](example-images/install-themes-dialog.png)\n\nSelect the theme you would like to install.\n\n![Select themes dialog](example-images/select-themes-dialog.png)\n\n### Carbon theme\n\n![Godot system for EmulationStation's Carbon theme](example-images/godot-engine-carbon-theme.png)\n\n### Pixel theme\n\n![Godot system for EmulationStation's Pixel theme](example-images/godot-engine-pixel-theme.png)\n\n## 🗒️ Changelog\n\nSee [CHANGELOG](/CHANGELOG.md).\n\n## 👤 Author\n\n**hiulit**\n\n- Twitter: [@hiulit](https://twitter.com/hiulit)\n- GitHub: [@hiulit](https://github.com/hiulit)\n\n## 🤝 Contributing\n\nFeel free to:\n\n- [Open an issue](https://github.com/hiulit/RetroPie-Godot-Engine-Emulator/issues) if you find a bug.\n- [Create a pull request](https://github.com/hiulit/RetroPie-Godot-Engine-Emulator/pulls) if you have a new cool feature to add to the project.\n- [Start a new discussion](https://github.com/hiulit/RetroPie-Godot-Engine-Emulator/discussions) about a feature request.\n\n## 🙌 Supporting this project\n\nIf you love this project or find it helpful, please consider supporting it through any size donations to help make it better ❤️.\n\n[![Become a patron](https://img.shields.io/badge/Become_a_patron-ff424d?logo=Patreon\u0026style=for-the-badge\u0026logoColor=white)](https://www.patreon.com/hiulit)\n\n[![Suppor me on Ko-Fi](https://img.shields.io/badge/Support_me_on_Ko--fi-F16061?logo=Ko-fi\u0026style=for-the-badge\u0026logoColor=white)](https://ko-fi.com/F2F7136ND)\n\n[![Buy me a coffee](https://img.shields.io/badge/Buy_me_a_coffee-FFDD00?logo=buy-me-a-coffee\u0026style=for-the-badge\u0026logoColor=black)](https://www.buymeacoffee.com/hiulit)\n\n[![Donate Paypal](https://img.shields.io/badge/PayPal-00457C?logo=PayPal\u0026style=for-the-badge\u0026label=Donate)](https://www.paypal.com/paypalme/hiulit)\n\nIf you can't, consider sharing it with the world...\n\n[![](https://img.shields.io/badge/Share_on_Twitter-1DA1F2?style=for-the-badge\u0026logo=twitter\u0026logoColor=white)](https://twitter.com/intent/tweet?url=https%3A%2F%2Fgithub.com%2Fhiulit%2FRetroPie-Godot-Engine-Emulator\u0026text=\"RetroPie+Godot+Engine+Emulator\"%3A%0D%0AA+scriptmodule+to+install+a+%23GodotEngine+\"emulator\"+for+%23RetroPie.%0Aby+%40hiulit%0A)\n\n... or giving it a [star ⭐️](https://github.com/hiulit/RetroPie-Godot-Engine-Emulator/stargazers).\n\nThank you very much!\n\n## 👏 Credits\n\nThanks to:\n\n- **Juan Linietsky** ([@reduz](https://github.com/reduz)), **Ariel Manzur** ([@punto-](https://github.com/punto-)), **Rémi Verschelde** ([@akien-mga](https://github.com/akien-mga)) and **all the Godot contributors** - For creating and maintaining the [Godot Engine](https://github.com/godotengine/godot).\n- **Emanuele Fornara** ([@efornara](https://github.com/efornara)) - For creating [FRT - A Godot \"platform\" targeting single board computers](https://github.com/efornara/frt).\n- **Andrea Calabró** - For creating the \"Godot logo\". Changes made to it:\n  - Created an outline version.\n- **Alícia Folgarona Ribot** ([@pingudroid](https://twitter.com/pingudroid)) - For creating the \"Pixel Godot logo\". Changes made to it:\n  - New colors.\n  - Added white outline.\n- **Florian Müller** - For creating the RetroPie logo.\n\n## 📝 Licenses\n\n- Source code: [MIT License](/LICENSE).\n- Godot Engine: [MIT License](/LICENSE_GODOT.txt).\n- FRT - A Godot platform targeting single board computers: [MIT License](/LICENSE_FRT.txt).\n- Godot logo: [CC BY](https://creativecommons.org/licenses/by/4.0/).\n- Pixel Godot logo: [CC BY-NC-SA](https://creativecommons.org/licenses/by-nc-sa/4.0/).\n- RetroPie logo: [CC BY-NC-ND](http://creativecommons.org/licenses/by-nc-nd/4.0/).\n","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fhiulit%2FRetroPie-Godot-Engine-Emulator","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Fhiulit%2FRetroPie-Godot-Engine-Emulator","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fhiulit%2FRetroPie-Godot-Engine-Emulator/lists"}