{"id":17024487,"url":"https://github.com/aitorres/dorustos","last_synced_at":"2025-03-22T18:31:10.495Z","repository":{"id":201074846,"uuid":"655448273","full_name":"aitorres/dorustos","owner":"aitorres","description":"A simple CHIP-8 emulator written in Rust","archived":false,"fork":false,"pushed_at":"2023-10-18T20:53:07.000Z","size":48,"stargazers_count":0,"open_issues_count":1,"forks_count":0,"subscribers_count":1,"default_branch":"main","last_synced_at":"2025-01-27T22:49:07.853Z","etag":null,"topics":["chip-8","chip8","emulators","rust"],"latest_commit_sha":null,"homepage":"","language":"Rust","has_issues":true,"has_wiki":null,"has_pages":null,"mirror_url":null,"source_name":null,"license":"agpl-3.0","status":null,"scm":"git","pull_requests_enabled":true,"icon_url":"https://github.com/aitorres.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}},"created_at":"2023-06-18T23:14:27.000Z","updated_at":"2023-06-18T23:16:15.000Z","dependencies_parsed_at":null,"dependency_job_id":"3182fd55-3612-4000-b21b-0a34ba779303","html_url":"https://github.com/aitorres/dorustos","commit_stats":null,"previous_names":["aitorres/dorustos"],"tags_count":0,"template":false,"template_full_name":null,"repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/aitorres%2Fdorustos","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/aitorres%2Fdorustos/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/aitorres%2Fdorustos/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/aitorres%2Fdorustos/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/aitorres","download_url":"https://codeload.github.com/aitorres/dorustos/tar.gz/refs/heads/main","host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":245002480,"owners_count":20545438,"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","chip8","emulators","rust"],"created_at":"2024-10-14T07:25:46.416Z","updated_at":"2025-03-22T18:31:05.476Z","avatar_url":"https://github.com/aitorres.png","language":"Rust","funding_links":[],"categories":[],"sub_categories":[],"readme":"# dorustos\n\n\u003ccenter\u003e\n\n![Screenshot of dorustos running a Tetris ROM](screenshot.png)\n\n\u003c/center\u003e\n\nA simple CHIP-8 emulator written in Rust, following the steps outlined at [An Introduction to Chip-8 Emulation using the Rust Programming Language](https://github.com/aquova/chip8-book).\n\nBuilt during a weekend afternoon with a big bag of Doritos (do Doritos count as chips?) while learning Rust from scratch :-)\n\n## Installation\n\nIn order to install this emulator you'll need `libsdl2` installed to your system. You should be able to achieve this by using `brew`, `apt` or your chosen OS's package manager.\n\nClone the repo and use `cargo` to build this project.\n\n```bash\ncargo build\n```\n\nAlternatively, you can install the project to Cargo's binaries folder.\n\n```bash\ncargo install --path .\n```\n\n## Usage\n\nIn order to use the emulator you'll need to find (or create!) a Chip-8 ROM. You can find these online, and the repo / guide linked above has [a few ROMs](https://github.com/aquova/chip8-book/tree/master/roms) you can use to try it out.\n\nAfter building, run the project by specifying the path to the file containing your ROM:\n\n```bash\ncargo run \u003cFILE\u003e\n\n# Example\ncargo run roms/CONNECT4\n```\n\nIf you installed the project instead, you can directly use the `dorustos` executable.\n\n```bash\ndorustos \u003cFILE\u003e\n\n# Example\ndorustos roms/CONNECT4\n```\n\n## Contributing\n\nPull requests, bug reports and discussions are welcome (and encouraged!). Please use this repo's issues to start any discussions and I'll try to respond as soon as possible.\n\nWhile there's no required coverage enforcement, I'd like to slowly add tests to (most of) the repo's codebase.\n\n## License\n\nThis codebase is licensed under the [GNU Affero General Public License](./LICENSE).\n","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Faitorres%2Fdorustos","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Faitorres%2Fdorustos","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Faitorres%2Fdorustos/lists"}