{"id":13436718,"url":"https://github.com/kondrak/rust64","last_synced_at":"2025-04-09T08:11:18.915Z","repository":{"id":1784589,"uuid":"41540654","full_name":"kondrak/rust64","owner":"kondrak","description":"Commodore 64 emulator written in Rust","archived":false,"fork":false,"pushed_at":"2023-07-08T12:52:25.000Z","size":2316,"stargazers_count":265,"open_issues_count":3,"forks_count":19,"subscribers_count":11,"default_branch":"master","last_synced_at":"2025-04-02T05:09:27.506Z","etag":null,"topics":["c64","commodore-64","emulation","emulator","rust"],"latest_commit_sha":null,"homepage":"","language":"Rust","has_issues":true,"has_wiki":null,"has_pages":null,"mirror_url":null,"source_name":null,"license":"mit","status":null,"scm":"git","pull_requests_enabled":true,"icon_url":"https://github.com/kondrak.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":"2015-08-28T10:07:14.000Z","updated_at":"2025-02-19T15:56:04.000Z","dependencies_parsed_at":"2024-10-27T19:14:20.233Z","dependency_job_id":"e6b12f3e-57e1-46bc-b5f1-6f1bb484b9a9","html_url":"https://github.com/kondrak/rust64","commit_stats":{"total_commits":325,"total_committers":6,"mean_commits":"54.166666666666664","dds":0.0461538461538461,"last_synced_commit":"5aaf07d7ccc6f2d14c1dfb7e14f6af63ba851ca3"},"previous_names":[],"tags_count":0,"template":false,"template_full_name":null,"repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/kondrak%2Frust64","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/kondrak%2Frust64/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/kondrak%2Frust64/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/kondrak%2Frust64/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/kondrak","download_url":"https://codeload.github.com/kondrak/rust64/tar.gz/refs/heads/master","host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":247999861,"owners_count":21031046,"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":["c64","commodore-64","emulation","emulator","rust"],"created_at":"2024-07-31T03:00:51.553Z","updated_at":"2025-04-09T08:11:18.893Z","avatar_url":"https://github.com/kondrak.png","language":"Rust","readme":"[![CI](https://github.com/kondrak/rust64/actions/workflows/rust.yml/badge.svg)](https://github.com/kondrak/rust64/actions/workflows/rust.yml)\n\n# Rust64 - a C64 emulator written in Rust\nThis is my attempt to study the Rust programming language and have fun at the same time. The goal is to present in the least obfuscated way how the Commodore 64 works and what's happening behind the scenes once you start a program. Emulation is cycle based and fairly accurate at this point.\n\nThe emulator has a built-in visual debugger which lets you view the contents of each memory page in RAM, Color RAM, VIC registers, CIA registers and SID registers. The VIC window is a ICU64-style raster debugger where each pixel represents one VIC cycle and any events occuring at that time.\n\nMajor dependencies\n------------------\n- minifb: https://crates.io/crates/minifb (works out of the box)\n- sdl2: https://crates.io/crates/sdl2 (requires extra steps, see [here](https://github.com/AngryLawyer/rust-sdl2) for instructions)\n\nRequires Rust 1.58.0 or higher to compile and run.\n\n### Youtube demo #1:\n[![Screenshot](images/rust64_youtube.png?raw=true)](https://www.youtube.com/watch?v=b6OSsTPwLaE)\n### Youtube demo #2:\n[![Screenshot](images/rust64_youtube2.png?raw=true)](https://www.youtube.com/watch?v=g4d_1vPV6So)\n### Screenshot:\n[![Screenshot](images/rust64_github_prev.png?raw=true)](images/rust64_github.png?raw=true)\n\n\n\nBuild instructions\n------------------\n```\ncargo build\ncargo run --release\n```\n\nYou can pass a .prg file as a command line parameter to load it into memory once the emulator boots (just type RUN to start the program):\n```\ncargo run --release prgs/colors.prg\n```\nTo run with double-sized window:\n```\ncargo run --release x2 prgs/colors.prg\n```\nTo run with double-sized window and debug windows enabled:\n```\ncargo run --release x2 debugger prgs/colors.prg\n```\n\nC64 and special key mappings\n-------------------\n```\nESC     - Run/Stop\nEND     - Restore\nTAB     - Control\nLCTRL   - C=\n`       - \u003c-\n-       - +\nINS     - \u0026\nHOME    - CLR/Home\nBSPACE  - INST/DEL\n[       - @\n]       - *\nDEL     - ^\n;       - :\n'       - ;\n\\       - =\nF11     - start asm output to console (very slow!)\nF12     - reset C64\nRCTRL   - joystick fire button\nNUMLOCK - toggle between joystick ports 1 and 2 (default: port 2)\n\nIn debugger window:\nPGUP/PGDWN - flip currently displayed memory page\nHOME/END   - switch currently displayed memory banks between RAM, Color RAM, VIC, CIA and SID\n```\n\nTODO\n------------------\n- serial bus/disk drives (d64, t64, tap)\n- implement remaining undocumented ops\n- switch from SDL2 to [cpal](https://github.com/tomaka/cpal) for audio once it supports OSX\n- improve SID emulation\n\nKnown Issues\n------------------\n- missing serial bus may cause some very specific programs to perform incorrectly or get stuck in infinite loops\n- elaborate programs that require very precise timing are not running correctly yet\n\nThis is an on-off WIP project, so update frequency may vary.\n\nResources\n------------------\nThe following documents and websites have been used to create this emulator:\n\n- http://www.zimmers.net/cbmpics/cbm/c64/vic-ii.txt\n- http://frodo.cebix.net/ (inspired the VIC-II and SID implementaiton)\n- https://www.c64-wiki.com\n- http://www.oxyron.de/html/opcodes02.html\n- http://www.6502.org/tutorials/6502opcodes.html\n- http://www.pagetable.com/c64rom/c64rom_en.html\n- http://archive.6502.org/datasheets/mos_6526_cia.pdf\n- https://www.yoyogames.com/tech_blog/95\n- http://code.google.com/p/hmc-6502/source/browse/trunk/emu/testvectors/AllSuiteA.asm\n- https://t.co/J40UKu7RBf\n- http://www.waitingforfriday.com/index.php/Commodore_SID_6581_Datasheet\n- http://sta.c64.org/cbm64mem.html\n- https://svn.code.sf.net/p/vice-emu/code/testprogs/\n- http://www.classiccmp.org/cini/pdf/Commodore/ds_6581.pdf\n\nSpecial thanks\n------------------\n- [Daniel Collin](https://twitter.com/daniel_collin) and Magnus \"Pantaloon\" Sjöberg for excessive test programs!\n- [Jake Taylor](https://twitter.com/ferristweetsnow) for general Rust tips!\n","funding_links":[],"categories":["Applications","Applications written in Rust","应用","应用 Applications","应用程序 Applications"],"sub_categories":["Emulators","仿真器","模拟器 Emulators"],"project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fkondrak%2Frust64","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Fkondrak%2Frust64","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fkondrak%2Frust64/lists"}