{"id":20731416,"url":"https://github.com/ezroot/gameboyemulator","last_synced_at":"2026-04-25T09:05:05.506Z","repository":{"id":258866608,"uuid":"874262437","full_name":"EZroot/GameBoyEmulator","owner":"EZroot","description":"Minimal game boy emulator that renders in CMD prompt","archived":false,"fork":false,"pushed_at":"2024-11-11T01:52:50.000Z","size":446,"stargazers_count":0,"open_issues_count":0,"forks_count":0,"subscribers_count":1,"default_branch":"main","last_synced_at":"2025-03-11T10:24:34.335Z","etag":null,"topics":["cmd","emulator","gameboy"],"latest_commit_sha":null,"homepage":"","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/EZroot.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":"2024-10-17T14:18:27.000Z","updated_at":"2024-11-11T01:52:53.000Z","dependencies_parsed_at":null,"dependency_job_id":"51225c03-0908-4fa3-b8c7-94edea8fc403","html_url":"https://github.com/EZroot/GameBoyEmulator","commit_stats":null,"previous_names":["ezroot/gameboyemulator"],"tags_count":0,"template":false,"template_full_name":null,"purl":"pkg:github/EZroot/GameBoyEmulator","repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/EZroot%2FGameBoyEmulator","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/EZroot%2FGameBoyEmulator/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/EZroot%2FGameBoyEmulator/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/EZroot%2FGameBoyEmulator/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/EZroot","download_url":"https://codeload.github.com/EZroot/GameBoyEmulator/tar.gz/refs/heads/main","sbom_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/EZroot%2FGameBoyEmulator/sbom","scorecard":null,"host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":286080680,"owners_count":32256221,"icon_url":"https://github.com/github.png","version":null,"created_at":"2022-05-30T11:31:42.601Z","updated_at":"2026-04-25T04:23:17.126Z","status":"ssl_error","status_checked_at":"2026-04-25T04:21:53.360Z","response_time":59,"last_error":"SSL_connect returned=1 errno=0 peeraddr=140.82.121.6:443 state=error: unexpected eof while reading","robots_txt_status":"success","robots_txt_updated_at":"2025-07-24T06:49:26.215Z","robots_txt_url":"https://github.com/robots.txt","online":false,"can_crawl_api":true,"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":["cmd","emulator","gameboy"],"created_at":"2024-11-17T05:14:48.600Z","updated_at":"2026-04-25T09:05:05.488Z","avatar_url":"https://github.com/EZroot.png","language":"C#","funding_links":[],"categories":[],"sub_categories":[],"readme":"\n# 🎮 GameBoyEmulator\n## 📜 Description\n\n**GameBoyEmulator** is a pure C# implementation of the original Game Boy hardware. It allows you to run Game Boy games in a Windows command-line environment, with support for key components like the CPU, memory, and graphics processing (PPU). ~~\u003csmall\u003eThis emulator focuses on accuracy and performance while maintaining a clean and readable codebase\u003c/small\u003e~~, making it a great resource for anyone interested in emulation or CPU architecture.\n\n## 🚀 Features\n\n- 🕹️ **Game Boy ROM Support**: Runs standard 32KB Game Boy ROMs.\n- 🧠 **CPU Emulation**: Partial instruction set coverage for the Game Boy's Z80-based CPU.\n- 🎨 **Graphics (PPU)**: Rendering of the Game Boy's 160x144 pixel screen, including background and sprites.\n- 🎮 **Input Handling**: Polling for joypad input for controlling in-game actions.\n- 🖥️ **Command Line Interface**: Simple CLI for loading and playing games.\n- 🛠️ **Debug Mode**: Step-through frame functionality for debugging game behavior.\n\n## 🖼️ Preview\n\n![Tetris Preview](https://raw.githubusercontent.com/EZroot/GameBoyEmulator/refs/heads/main/GameBoyEmulator/screenshots/gameboyemulator.gif)\n\n*Screenshot of Tetris running on GameBoyEmulator*\n\n## 🛠️ Getting Started\n\n### Prerequisites\n\n- 🟢 **.NET Core** \n- 🟢 **Any OS** \n\n### Installation\n\n1. Clone the repository:\n\n    ```bash\n    git clone https://github.com/EZroot/GameBoyEmulator.git\n    ```\n\n2. Open the solution in **Visual Studio** or your preferred IDE.\n\n3. Build the project to generate the executable.\n\n### Running the Emulator\n\n1. Place your **Game Boy ROM** files in the same directory as the emulator executable.\n\n2. Run the emulator via the command line:\n\n    ```bash\n    GameBoyEmulator.exe path_to_rom.gb\n    ```\n\n### 🎮 Controls\n\n- **Arrow Keys**: D-Pad (Up, Down, Left, Right)\n- **Z**: A Button\n- **X**: B Button\n- **Spacebar**: Start\n- **A**: Select\n\n## 🤝 Contributing\n\nIf you'd like to contribute to this project, feel free to fork the repository and submit a pull request. Contributions for new features, performance improvements, and bug fixes are highly welcome!\n\n## 📄 License\n\nThis project is licensed under the MIT License. See the [LICENSE](LICENSE) file for more details.\n\n## 🙌 Acknowledgments\n\n- Inspired by various **Game Boy emulators** and resources that explain the Game Boy hardware.\n- Special thanks to the **open-source community** for providing a wealth of resources on emulation.\n","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fezroot%2Fgameboyemulator","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Fezroot%2Fgameboyemulator","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fezroot%2Fgameboyemulator/lists"}