{"id":13714010,"url":"https://github.com/h4ck3rk3y/go-8","last_synced_at":"2026-01-31T12:39:17.437Z","repository":{"id":89817105,"uuid":"131001919","full_name":"h4ck3rk3y/go-8","owner":"h4ck3rk3y","description":"A chip-8 emulator written in Go","archived":false,"fork":false,"pushed_at":"2019-01-22T07:37:39.000Z","size":39,"stargazers_count":23,"open_issues_count":1,"forks_count":3,"subscribers_count":3,"default_branch":"master","last_synced_at":"2024-12-06T21:39:10.433Z","etag":null,"topics":["chip-8","ebiten","emulator","go","golang"],"latest_commit_sha":null,"homepage":null,"language":"Go","has_issues":true,"has_wiki":null,"has_pages":null,"mirror_url":null,"source_name":null,"license":"lgpl-3.0","status":null,"scm":"git","pull_requests_enabled":true,"icon_url":"https://github.com/h4ck3rk3y.png","metadata":{"files":{"readme":"README.md","changelog":null,"contributing":null,"funding":null,"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}},"created_at":"2018-04-25T12:19:51.000Z","updated_at":"2024-09-13T06:02:34.000Z","dependencies_parsed_at":"2024-05-21T20:01:21.400Z","dependency_job_id":null,"html_url":"https://github.com/h4ck3rk3y/go-8","commit_stats":null,"previous_names":[],"tags_count":0,"template":false,"template_full_name":null,"repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/h4ck3rk3y%2Fgo-8","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/h4ck3rk3y%2Fgo-8/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/h4ck3rk3y%2Fgo-8/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/h4ck3rk3y%2Fgo-8/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/h4ck3rk3y","download_url":"https://codeload.github.com/h4ck3rk3y/go-8/tar.gz/refs/heads/master","host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":252793029,"owners_count":21805053,"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":["chip-8","ebiten","emulator","go","golang"],"created_at":"2024-08-02T23:01:50.021Z","updated_at":"2026-01-31T12:39:17.389Z","avatar_url":"https://github.com/h4ck3rk3y.png","language":"Go","funding_links":[],"categories":["Repositories"],"sub_categories":[],"readme":"[![CircleCI](https://circleci.com/gh/h4ck3rk3y/go-8.svg?style=svg)](https://circleci.com/gh/h4ck3rk3y/go-8)\n\n# go-8 \nA chip-8 emulator written in Go. I am trying to learn go-lang for fun and I have always been fascinated with emulators, so I decided to write one in Go. I am using the following [manual](http://devernay.free.fr/hacks/chip8/C8TECH10.HTM#1nnn) as reference.\n\nYou'll need the drivers required by ebiten and you can find the relevant installation instructions [here](https://github.com/hajimehoshi/ebiten/wiki/Linux).\n\nI wrote a blog post about this project which you can find [here](https://gyani.net/blog/chip-8/)\n\n![Screen Shot](screenshots/PONG.png?raw=true)\n\n## Test Instructions\n\n```bash\n- git clone http://github.com/h4ck3rk3y/go-8\n- cd go-8\n- go get -v -t -d ./...\n- go test --cover\n```\n\n## Build Instructions\n\nYou can build the program by\n\n```bash\n- git clone http://github.com/h4ck3rk3y/go-8\n- cd go-8\n- go get -v -t -d ./...\n- go build main.go cpu.go\n```\n\n## Run Instructions\n\nBuild the code and then\n\n```bash\n- ./main\n```\n## Key Configuration\n\nThe original chip-8 consisted of a hexa decimal gamepad. I use the following mappings.\n\n- Your Key Board --\u003e Chip 8\n- 1 --\u003e 1\n- 2 --\u003e 2\n- 3 --\u003e 3\n- 4 --\u003e C\n- Q --\u003e 4\n- W --\u003e 5\n- E --\u003e 6\n- R --\u003e D\n- A --\u003e 7\n- S --\u003e 8\n- D --\u003e 9\n- F --\u003e E\n- Z --\u003e A\n- X --\u003e 0\n- C --\u003e B\n- V --\u003e F\n\n## To Do\n\n- Make roms passable as command line arguments\n- Key board mapping in a configuration file\n- Configurable colors\n- Better unit tests for main.go. cpu.go has 98.8% coverage but overall the coverage drops significantly\n","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fh4ck3rk3y%2Fgo-8","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Fh4ck3rk3y%2Fgo-8","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fh4ck3rk3y%2Fgo-8/lists"}