{"id":13620543,"url":"https://github.com/mierau/gamekid","last_synced_at":"2026-01-23T00:55:09.586Z","repository":{"id":37557612,"uuid":"164742440","full_name":"mierau/gamekid","owner":"mierau","description":"Play Game Boy games on your Playdate.","archived":false,"fork":false,"pushed_at":"2024-03-26T19:10:00.000Z","size":370,"stargazers_count":228,"open_issues_count":10,"forks_count":9,"subscribers_count":17,"default_branch":"master","last_synced_at":"2024-08-01T21:44:32.309Z","etag":null,"topics":["emulation","emulator","gameboy","gameboy-emulator","playdate"],"latest_commit_sha":null,"homepage":"https://gamekid.fun","language":"C","has_issues":true,"has_wiki":null,"has_pages":null,"mirror_url":null,"source_name":null,"license":null,"status":null,"scm":"git","pull_requests_enabled":true,"icon_url":"https://github.com/mierau.png","metadata":{"files":{"readme":"README.md","changelog":null,"contributing":null,"funding":null,"license":null,"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}},"created_at":"2019-01-08T22:15:42.000Z","updated_at":"2024-07-29T14:21:40.000Z","dependencies_parsed_at":"2024-01-22T01:09:50.019Z","dependency_job_id":"50e328b9-652b-456c-8fd6-8fcf4901599f","html_url":"https://github.com/mierau/gamekid","commit_stats":null,"previous_names":[],"tags_count":6,"template":false,"template_full_name":null,"repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/mierau%2Fgamekid","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/mierau%2Fgamekid/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/mierau%2Fgamekid/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/mierau%2Fgamekid/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/mierau","download_url":"https://codeload.github.com/mierau/gamekid/tar.gz/refs/heads/master","host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":223647975,"owners_count":17179359,"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":["emulation","emulator","gameboy","gameboy-emulator","playdate"],"created_at":"2024-08-01T21:00:57.034Z","updated_at":"2026-01-23T00:55:09.576Z","avatar_url":"https://github.com/mierau.png","language":"C","funding_links":[],"categories":["C"],"sub_categories":[],"readme":"# Gamekid\nA community built Game Boy emulator for [Playdate](https://play.date).  \nThe emulator backend is provided by the equally teeny [PeanutGB](https://github.com/deltabeard/Peanut-GB).  \nThis is still very much a work in progress. FPS is not yet where we want it to be but it'll get there in time. Join in, help us out! :)\n\n## Install\n1. [Download](https://github.com/mierau/gamekid/releases/) the latest version of Gamekid.\n2. [Sideload](https://play.date/account/sideload/) the resulting pdx on your Playdate.\n\n## Install Games\nThe Game Boy has a bustling homebrew community. There are various sources online, but [Itch](https://itch.io/games/tag-gameboy/tag-homebrew) or [Homebrew Hub](https://gbhh.avivace.com/games) seem to be good places to start.\n1. Reboot your Playdate into Data Disk mode (Settings \u003e System \u003e Reboot to Data Disk).\n2. Connect your Playdate to your computer.\n3. Open/select the Playdate drive when it appears.\n4. Copy your .gb files into the `Data/\u003cgamekid folder\u003e/games` folder.\n5. Unmount the Playdate.\n6. That's it. Run Gamekid. Enjoy!\n\n## Usage\nOnce installed and games stashed safely on your Playdate, using Gamekid is fairly straightforward. Simply open Gamekid.\nYour games should load on the following screen. Select a game to run. Not all games run flawlessly and some have serious\nFPS issues to the point of unplayability, but I'm convinced we can fix these in time.\n\nStart/Select: Move the crank to activate start/select buttons.  \nOpen the Playdate menu for scaling and interlacing options.\n\n## Building\n1. If you're building on Apple silicon (M1, M2, etc.), make sure you have Rosetta installed as the ARM toolchain is built for Intel processors. You can do this on the command line: `softwareupdate --install-rosetta`\n2. Review Panic's [How to use the C API](https://sdk.play.date/2.0.1/Inside%20Playdate%20with%20C.html#_how_to_use_the_c_api) doc. \n3. Grab a copy of [Playdate SDK](https://play.date/dev/) for your system.\n4. Run `make` within the Gamekid folder. OR! grab yourself a copy of [Nova](https://nova.app) from [Panic](https://panic.com) (makers of the Playdate).\n\n## Contributing\nGamekid is pretty good, but it isn't perfect. But we can get it there with your help!  \nConnect with me on Twitter [@dmierau](https://twitter.com/dmierau)—I'm pretty active there (for better or worse).  \nSimply make pull requests and I'll look over changes and merge.\n\n## PeanutGB\nGamekid sits atop the wonderfully compact [PeanutGB](https://github.com/deltabeard/Peanut-GB) emulator backend. This emulator is designed for efficiency over accuracy.\n\n## TODO\n- Sound support\n- Visual affordance for crank start/select\n- FPS optimizations\n\n## License\nMatching the [PeanutGB](https://github.com/deltabeard/Peanut-GB) license here, which is MIT.","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fmierau%2Fgamekid","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Fmierau%2Fgamekid","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fmierau%2Fgamekid/lists"}