{"id":15048865,"url":"https://github.com/kutu-dev/och8s","last_synced_at":"2026-03-04T09:31:28.075Z","repository":{"id":246901801,"uuid":"824316221","full_name":"kutu-dev/och8S","owner":"kutu-dev","description":"A CHIP-8 emulator made with C23 and SDL2. ","archived":false,"fork":false,"pushed_at":"2024-07-11T10:52:21.000Z","size":2301,"stargazers_count":0,"open_issues_count":0,"forks_count":0,"subscribers_count":2,"default_branch":"master","last_synced_at":"2025-01-13T04:50:26.586Z","etag":null,"topics":["c-lang","c-language","c23","chip-8","chip-8-emulator","emulator"],"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/kutu-dev.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-07-04T21:08:55.000Z","updated_at":"2024-07-11T10:52:25.000Z","dependencies_parsed_at":"2024-10-12T17:02:50.579Z","dependency_job_id":"ae31c913-0387-4a6b-a245-80a7440ecfb2","html_url":"https://github.com/kutu-dev/och8S","commit_stats":null,"previous_names":["kutu-dev/och8s"],"tags_count":0,"template":false,"template_full_name":null,"repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/kutu-dev%2Foch8S","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/kutu-dev%2Foch8S/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/kutu-dev%2Foch8S/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/kutu-dev%2Foch8S/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/kutu-dev","download_url":"https://codeload.github.com/kutu-dev/och8S/tar.gz/refs/heads/master","host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":241549086,"owners_count":19980475,"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":["c-lang","c-language","c23","chip-8","chip-8-emulator","emulator"],"created_at":"2024-09-24T21:16:55.020Z","updated_at":"2025-11-27T09:03:46.029Z","avatar_url":"https://github.com/kutu-dev.png","language":"C","funding_links":[],"categories":[],"sub_categories":[],"readme":"\u003cdiv align=\"center\"\u003e\n\u003cimg src=\"./static/logo.png\" width=\"256\"\u003e\n\u003ch1\u003eoch8S\u003c/h1\u003e\n\n![och8S version logo](https://img.shields.io/badge/Version-1.0.0-FA1909?style=flat)\n![C23 version logo](https://img.shields.io/badge/C23-3949AB?style=flat\u0026logo=c)\n![GNU GCC version logo](https://img.shields.io/badge/gcc-v14%2B-FFD0AD?style=flat\u0026logo=gnu)\n\nA CHIP-8 emulator made with C23 and SDL2.\n\u003c/div\u003e\n\n## Prerequisites\n- `gcc` compiler version 14 or later (`clang` can be used but the Meson setup can't be done with `just`).\n- The [Meson build system](https://mesonbuild.com/).\n- The [Just command runner](https://just.systems/man/en/).\n- [`SDL2`](https://wiki.libsdl.org/SDL2/FrontPage) with development files installed.\n\nIf you are using the [Nix package manager](https://nixos.org/) you may be interested in the provided [`flake.nix`](./flake.nix) file.\n\n## Usage\nFirst setup the project:\n```sh\njust setup\n```\n\nThen just compile and run it pointing to your ROM file:\n```sh\njust run \u003crom-path\u003e\n```\n\nThe following executions can just be made by pointing to the previously compiled file:\n```sh\nbuild/src/och8S \u003crom-path\u003e\n```\n\n### Controls\nThe CHIP-8's keypad is mapped like this:\n```\n123C  -\u003e  1234 \n456D  -\u003e  QWER\n789E  -\u003e  ASDF\nA0BF  -\u003e  ZXCV\n```\n\nThe emulator has basic savestate capabilities:\n- Save to the savefile: `N`.\n- Load from the savefile: `M`.\n\n\u003e [!WARNING]\n\u003e For Windows users:\n\u003e och8S uses the POSIX only `getopt()` function from the header `unistd.h` so the usage of [MinGW](https://www.mingw-w64.org/) or [Cygwin](https://cygwin.com/) is obligatory to be able to compile the Windows NT platform.\n\n## Acknowledgements\n- Created with :heart: by [Jorge \"Kutu\" Dobón Blanco](https://dobon.dev).\n","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fkutu-dev%2Foch8s","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Fkutu-dev%2Foch8s","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fkutu-dev%2Foch8s/lists"}