{"id":23160903,"url":"https://github.com/awkless/chip-8","last_synced_at":"2025-05-12T12:44:27.837Z","repository":{"id":87556714,"uuid":"599796644","full_name":"awkless/chip-8","owner":"awkless","description":"Chip-8 emulator implementation in standard C","archived":false,"fork":false,"pushed_at":"2023-05-05T01:19:27.000Z","size":145,"stargazers_count":1,"open_issues_count":0,"forks_count":3,"subscribers_count":1,"default_branch":"main","last_synced_at":"2025-03-31T22:11:30.487Z","etag":null,"topics":["c99","chip-8","emulator","make","sdl2"],"latest_commit_sha":null,"homepage":"https://www.awkless.com/chip-8/","language":"C","has_issues":true,"has_wiki":null,"has_pages":null,"mirror_url":null,"source_name":null,"license":"other","status":null,"scm":"git","pull_requests_enabled":true,"icon_url":"https://github.com/awkless.png","metadata":{"files":{"readme":"README.md","changelog":null,"contributing":"CONTRIBUTING.md","funding":null,"license":"LICENSE.md","code_of_conduct":null,"threat_model":null,"audit":null,"citation":null,"codeowners":".github/CODEOWNERS","security":null,"support":null,"governance":null,"roadmap":null,"authors":"AUTHORS.md","dei":null,"publiccode":null,"codemeta":null}},"created_at":"2023-02-09T22:34:37.000Z","updated_at":"2023-04-06T18:36:14.000Z","dependencies_parsed_at":null,"dependency_job_id":"b6eea4af-c2f2-4d64-9a09-5ddd22473984","html_url":"https://github.com/awkless/chip-8","commit_stats":null,"previous_names":[],"tags_count":5,"template":false,"template_full_name":null,"repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/awkless%2Fchip-8","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/awkless%2Fchip-8/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/awkless%2Fchip-8/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/awkless%2Fchip-8/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/awkless","download_url":"https://codeload.github.com/awkless/chip-8/tar.gz/refs/heads/main","host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":253743344,"owners_count":21957197,"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":["c99","chip-8","emulator","make","sdl2"],"created_at":"2024-12-17T23:12:36.603Z","updated_at":"2025-05-12T12:44:27.814Z","avatar_url":"https://github.com/awkless.png","language":"C","funding_links":[],"categories":[],"sub_categories":[],"readme":"\u003c!--\nSPDX-FileCopyrightText: 2023 Jason Pena \u003cjasonpena@awkless.com\u003e\nSPDX-License-Identifier: MIT\n--\u003e\n\n[![REUSE status][reuse-badge]][reuse-repo]\n\n# Chip-8 Emulator\n\nThis is yet another [Chip-8][chip-8-wiki] emulator project aimed at emulating\nthe baseline features of the Chip-8 system from 1977. This project does not\naim to be the fastest, nor the most accurate. Instead, the goal was to\ncreate a simple emulator both in design and maintenance.\n\n## Project Site\n\nIf you want to know about the development of this project then follow this URL\n\\\u003c\u003chttps://awkless.github.io/chip-8/\u003e\\\u003e, which is a simple GitHub pages website.\n\n## Usage\n\nPerform the following in the terminal:\n\n```\n# chip-8 -l \u003crom\u003e\n```\n\nWhere `\u003crom\u003e` is any proper Chip-8 ROM file that you want to play. This\nemulator uses the following key layout as input:\n\n```\n1 2 3 4\nQ W E R\nA S D F\nZ X C V\n```\n\nwhich map to these traditional Chip-8 keys:\n\n```\n1 2 3 C\n4 5 6 D\n7 8 9 E\nA 0 B F\n```\n\nWhen you load a ROM a new window will pop up so you can play your\nChip-8 game using the keyboard controls labeled above.\n\nThe `games` directory contains some sample CHIP-8 roms that you can play around\nwith in the project. If you forget how to use the emulator then just run the\nfollowing into your terminal:\n\n```\n# chip-8 -h\n```\n\nfor a simple help message.\n\n## Installation\n\nYou will need the following software:\n\n- C99 compliant compiler.\n- SDL2 library.\n- Git [\u003e= 2.20].\n- Posix compliant Make.\n\nAfter cloning this project, run the following commands at the top level of the\nproject:\n\n```\n# make\n# sudo make install\n```\n\nYou now have the `chip-8` program installed!\n\n## Contribution\n\nThis project is open to the following forms of contribution:\n\n- Bug reports\n- Feature requests\n- Improvements or fixes to dotfiles\n- Improvements or fixes to scripts\n- Improvements or fixes to CI pipeline\n- Improvements or fixes to documentation\n\nPlease follow the guidelines outlined by the provided\n[contribution guideline file][contributing]. Pull requests will not be accepted\nif these guidelines are violated without good reason.\n\n## License\n\nThis project uses the [MIT license][mit] for all source code and documentation.\n\n[reuse-badge]: https://api.reuse.software/badge/github.com/fsfe/reuse-tool\n[reuse-repo]: https://api.reuse.software/info/github.com/fsfe/reuse-tool\n[contributing]: https://github.com/awkless/chip-8/blob/main/CONTRIBUTING.md\n[chip-8-wiki]: https://en.wikipedia.org/wiki/CHIP-8\n[mit]: https://github.com/awkless/chip-8/blob/main/LICENSE/MIT.txt\n","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fawkless%2Fchip-8","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Fawkless%2Fchip-8","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fawkless%2Fchip-8/lists"}