{"id":13436748,"url":"https://github.com/koute/pinky","last_synced_at":"2025-04-04T06:07:19.523Z","repository":{"id":44315454,"uuid":"71717084","full_name":"koute/pinky","owner":"koute","description":"An NES emulator written in Rust","archived":false,"fork":false,"pushed_at":"2023-11-27T14:30:36.000Z","size":1149,"stargazers_count":770,"open_issues_count":10,"forks_count":48,"subscribers_count":25,"default_branch":"master","last_synced_at":"2024-10-14T13:07:29.409Z","etag":null,"topics":[],"latest_commit_sha":null,"homepage":null,"language":"Rust","has_issues":true,"has_wiki":null,"has_pages":null,"mirror_url":null,"source_name":null,"license":"apache-2.0","status":null,"scm":"git","pull_requests_enabled":true,"icon_url":"https://github.com/koute.png","metadata":{"files":{"readme":"README.md","changelog":null,"contributing":null,"funding":null,"license":"LICENSE-APACHE.txt","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":"2016-10-23T17:05:43.000Z","updated_at":"2024-10-01T19:30:58.000Z","dependencies_parsed_at":"2022-08-28T04:01:38.359Z","dependency_job_id":"dbf2b80e-5e0a-4097-b1d6-b420765b6d77","html_url":"https://github.com/koute/pinky","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/koute%2Fpinky","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/koute%2Fpinky/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/koute%2Fpinky/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/koute%2Fpinky/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/koute","download_url":"https://codeload.github.com/koute/pinky/tar.gz/refs/heads/master","host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":247128744,"owners_count":20888235,"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":[],"created_at":"2024-07-31T03:00:51.836Z","updated_at":"2025-04-04T06:07:19.505Z","avatar_url":"https://github.com/koute.png","language":"Rust","readme":"[![Build Status](https://api.travis-ci.org/koute/pinky.svg)](https://travis-ci.org/koute/pinky)\n\n# Pinky\n\nPinky is an [NES] emulator written in [Rust] completely from scratch\nbased only on [publicly available documentation].\n\nYou can [run it in your Web browser](http://koute.github.io/pinky-web/)!\n\n[NES]: https://en.wikipedia.org/wiki/Nintendo_Entertainment_System\n[Rust]: https://www.rust-lang.org/en-US/\n[publicly available documentation]: http://wiki.nesdev.com/w/index.php/Nesdev_Wiki\n\n## Features\n\n   * Accurate-ish (cycle accurate) 6502, PPU and APU emulation.\n   * A testsuite based on test ROMs.\n   * A PPU testsuite automatically generated from a transistor-level\n     simulation of a real PPU.\n   * Supports NROM (0), MMC1 (1), UxROM (2), AxROM (7) and UNROM 512 (30) mappers.\n   * Can be compiled as a [libretro] core.\n   * Can be compiled into WebAssembly.\n\n[libretro]: http://www.libretro.com/index.php/api/\n\nThere are still many things missing, including:\n\n   * Most unofficial 6502 instructions.\n   * Support for other mappers.\n   * Accurate PPU sprite overflow.\n   * Savestate support.\n   * PAL support.\n\nCurrently this is **not** a production quality emulator, though\nwhatever games it can play (due to limited mapper support) it can\nplay quite well (e.g. such games as Super Mario Brothers, Donkey Kong\nor Tetris; you can check out [nesmapper.txt] which will tell you\nwhich game use which mapper).\n\n[nesmapper.txt]: http://tuxnes.sourceforge.net/nesmapper.txt\n\n## Getting started\n\nInternally this project is split into multiple crates.\n\nThe `pinky-libretro` contains the libretro core of this emulator,\nwhich is the intended way to run it. It should be compatible with\nany libretro frontend, but it was only tested with [RetroArch].\n\nTo compile the libretro core go into the `pinky-libretro` directory\nand type:\n\n```\ncargo build\n```\n\nThis should build a shared object in `target/debug` called `libpinky_libretro.so`\n(on non-Linux systems the extension might be different, e.g. on Windows it'll be a `.dll`)\nwhich then you can use with RetroArch like this:\n\n```\nretroarch -L libpinky_libretro.so your_rom.nes\n```\n\nYou can also run `cargo build --release` to build a significantly better optimized\nversion (the debug build should run full speed on modern systems though).\n\nThere's also a simple standalone SDL2-based frontend in the `pinky-devui`\ndirectory; running it is just a matter of passing it a path to your game ROM\non the command line.\n\n[Retroarch]: http://www.libretro.com/index.php/retroarch-2/\n\nThe `nes-testsuite` contains an emulator agnostic testsuite of NES roms,\nwhich could be easily hooked to any other emulator simply by implementing\na single trait (see `nes/src/testsuite.rs`).\n\nThe `rp2c02-testsuite` contains a PPU testsuite which is autogenerated\nwith the help of [Visual2C02], which is a transistor-level simulator\nof an actual NES PPU.\n\nThe `nes` contains the emulator itself. `mos6502` has the 6502 interpreter,\nwhich could be useful for emulating other 6502-based machines.\n\n[Visual2C02]: https://www.qmtpro.com/~nes/chipimages/visual2c02/\n\n## There are already hundreds of NES emulators out there; why another?\n\nBecause why not? Writing a game console emulator is one of the most fun and\nrewarding projects out there, and nothing can compare with the feeling of\nbeating one of your favorite games on an emulator you've wrote yourself.\n\nThe choice of NES is also an obvious one - it's the least time consuming\nconsole to emulate simply due to the fact that it's extremely well documented.\n","funding_links":[],"categories":["Applications","Rust","Home Game Console Emulators","Applications written in Rust","应用","应用 Applications","应用程序 Applications"],"sub_categories":["Emulators","Nintendo","仿真器","模拟器 Emulators"],"project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fkoute%2Fpinky","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Fkoute%2Fpinky","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fkoute%2Fpinky/lists"}