{"id":37078045,"url":"https://github.com/jameskmurphy/nes","last_synced_at":"2026-01-14T09:03:18.404Z","repository":{"id":50617127,"uuid":"329080722","full_name":"jameskmurphy/nes","owner":"jameskmurphy","description":"A Nintendo Entertainment System (NES) emulator in Python and Cython.","archived":false,"fork":false,"pushed_at":"2021-05-14T23:08:32.000Z","size":1171,"stargazers_count":134,"open_issues_count":2,"forks_count":12,"subscribers_count":8,"default_branch":"main","last_synced_at":"2025-11-30T11:35:25.558Z","etag":null,"topics":["cython","emulation","emulator","nes","nes-emulator","python"],"latest_commit_sha":null,"homepage":"","language":"Python","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/jameskmurphy.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}},"created_at":"2021-01-12T18:45:56.000Z","updated_at":"2025-11-06T12:17:35.000Z","dependencies_parsed_at":"2022-08-12T21:50:43.484Z","dependency_job_id":null,"html_url":"https://github.com/jameskmurphy/nes","commit_stats":null,"previous_names":[],"tags_count":0,"template":false,"template_full_name":null,"purl":"pkg:github/jameskmurphy/nes","repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/jameskmurphy%2Fnes","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/jameskmurphy%2Fnes/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/jameskmurphy%2Fnes/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/jameskmurphy%2Fnes/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/jameskmurphy","download_url":"https://codeload.github.com/jameskmurphy/nes/tar.gz/refs/heads/main","sbom_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/jameskmurphy%2Fnes/sbom","scorecard":{"id":503901,"data":{"date":"2025-08-11","repo":{"name":"github.com/jameskmurphy/nes","commit":"d2fb20be164a766dbb6ad17f4cccb9518455fee0"},"scorecard":{"version":"v5.2.1-40-gf6ed084d","commit":"f6ed084d17c9236477efd66e5b258b9d4cc7b389"},"score":3,"checks":[{"name":"Token-Permissions","score":-1,"reason":"No tokens found","details":null,"documentation":{"short":"Determines if the project's workflows follow the principle of least privilege.","url":"https://github.com/ossf/scorecard/blob/f6ed084d17c9236477efd66e5b258b9d4cc7b389/docs/checks.md#token-permissions"}},{"name":"Code-Review","score":0,"reason":"Found 0/30 approved changesets -- score normalized to 0","details":null,"documentation":{"short":"Determines if the project requires human code review before pull requests (aka merge requests) are merged.","url":"https://github.com/ossf/scorecard/blob/f6ed084d17c9236477efd66e5b258b9d4cc7b389/docs/checks.md#code-review"}},{"name":"Maintained","score":0,"reason":"0 commit(s) and 0 issue activity found in the last 90 days -- score normalized to 0","details":null,"documentation":{"short":"Determines if the project is \"actively maintained\".","url":"https://github.com/ossf/scorecard/blob/f6ed084d17c9236477efd66e5b258b9d4cc7b389/docs/checks.md#maintained"}},{"name":"Packaging","score":-1,"reason":"packaging workflow not detected","details":["Warn: no GitHub/GitLab publishing workflow detected."],"documentation":{"short":"Determines if the project is published as a package that others can easily download, install, easily update, and uninstall.","url":"https://github.com/ossf/scorecard/blob/f6ed084d17c9236477efd66e5b258b9d4cc7b389/docs/checks.md#packaging"}},{"name":"Dangerous-Workflow","score":-1,"reason":"no workflows found","details":null,"documentation":{"short":"Determines if the project's GitHub Action workflows avoid dangerous patterns.","url":"https://github.com/ossf/scorecard/blob/f6ed084d17c9236477efd66e5b258b9d4cc7b389/docs/checks.md#dangerous-workflow"}},{"name":"Binary-Artifacts","score":10,"reason":"no binaries found in the repo","details":null,"documentation":{"short":"Determines if the project has generated executable (binary) artifacts in the source repository.","url":"https://github.com/ossf/scorecard/blob/f6ed084d17c9236477efd66e5b258b9d4cc7b389/docs/checks.md#binary-artifacts"}},{"name":"SAST","score":0,"reason":"no SAST tool detected","details":["Warn: no pull requests merged into dev branch"],"documentation":{"short":"Determines if the project uses static code analysis.","url":"https://github.com/ossf/scorecard/blob/f6ed084d17c9236477efd66e5b258b9d4cc7b389/docs/checks.md#sast"}},{"name":"Pinned-Dependencies","score":-1,"reason":"no dependencies found","details":null,"documentation":{"short":"Determines if the project has declared and pinned the dependencies of its build process.","url":"https://github.com/ossf/scorecard/blob/f6ed084d17c9236477efd66e5b258b9d4cc7b389/docs/checks.md#pinned-dependencies"}},{"name":"CII-Best-Practices","score":0,"reason":"no effort to earn an OpenSSF best practices badge detected","details":null,"documentation":{"short":"Determines if the project has an OpenSSF (formerly CII) Best Practices Badge.","url":"https://github.com/ossf/scorecard/blob/f6ed084d17c9236477efd66e5b258b9d4cc7b389/docs/checks.md#cii-best-practices"}},{"name":"Security-Policy","score":0,"reason":"security policy file not detected","details":["Warn: no security policy file detected","Warn: no security file to analyze","Warn: no security file to analyze","Warn: no security file to analyze"],"documentation":{"short":"Determines if the project has published a security policy.","url":"https://github.com/ossf/scorecard/blob/f6ed084d17c9236477efd66e5b258b9d4cc7b389/docs/checks.md#security-policy"}},{"name":"Vulnerabilities","score":10,"reason":"0 existing vulnerabilities detected","details":null,"documentation":{"short":"Determines if the project has open, known unfixed vulnerabilities.","url":"https://github.com/ossf/scorecard/blob/f6ed084d17c9236477efd66e5b258b9d4cc7b389/docs/checks.md#vulnerabilities"}},{"name":"Fuzzing","score":0,"reason":"project is not fuzzed","details":["Warn: no fuzzer integrations found"],"documentation":{"short":"Determines if the project uses fuzzing.","url":"https://github.com/ossf/scorecard/blob/f6ed084d17c9236477efd66e5b258b9d4cc7b389/docs/checks.md#fuzzing"}},{"name":"License","score":10,"reason":"license file detected","details":["Info: project has a license file: LICENSE:0","Info: FSF or OSI recognized license: MIT License: LICENSE:0"],"documentation":{"short":"Determines if the project has defined a license.","url":"https://github.com/ossf/scorecard/blob/f6ed084d17c9236477efd66e5b258b9d4cc7b389/docs/checks.md#license"}},{"name":"Signed-Releases","score":-1,"reason":"no releases found","details":null,"documentation":{"short":"Determines if the project cryptographically signs release artifacts.","url":"https://github.com/ossf/scorecard/blob/f6ed084d17c9236477efd66e5b258b9d4cc7b389/docs/checks.md#signed-releases"}},{"name":"Branch-Protection","score":0,"reason":"branch protection not enabled on development/release branches","details":["Warn: branch protection not enabled for branch 'main'"],"documentation":{"short":"Determines if the default and release branches are protected with GitHub's branch protection settings.","url":"https://github.com/ossf/scorecard/blob/f6ed084d17c9236477efd66e5b258b9d4cc7b389/docs/checks.md#branch-protection"}}]},"last_synced_at":"2025-08-19T22:47:49.385Z","repository_id":50617127,"created_at":"2025-08-19T22:47:49.385Z","updated_at":"2025-08-19T22:47:49.385Z"},"host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":286080680,"owners_count":28414732,"icon_url":"https://github.com/github.png","version":null,"created_at":"2022-05-30T11:31:42.601Z","updated_at":"2026-01-14T08:38:59.149Z","status":"ssl_error","status_checked_at":"2026-01-14T08:38:43.588Z","response_time":107,"last_error":"SSL_connect returned=1 errno=0 peeraddr=140.82.121.6:443 state=error: unexpected eof while reading","robots_txt_status":"success","robots_txt_updated_at":"2025-07-24T06:49:26.215Z","robots_txt_url":"https://github.com/robots.txt","online":false,"can_crawl_api":true,"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":["cython","emulation","emulator","nes","nes-emulator","python"],"created_at":"2026-01-14T09:03:17.773Z","updated_at":"2026-01-14T09:03:18.390Z","avatar_url":"https://github.com/jameskmurphy.png","language":"Python","funding_links":[],"categories":[],"sub_categories":[],"readme":"# Pyntendo\n\n    pip install pyntendo\n\nA Nintendo Entertainment System (NES) emulator written in Python and Cython.\n* All core components are implemented, including audio, and the most important mappers.\n* Performant (runs at 60fps on modern machines)\n* Fully headless operation is supported\n  * NumPy-based input/output\n  * Very limited external dependencies (really just NumPy)\n  * See [Headless Demo](Headless%20Demo.ipynb) for a minimal example\n* Pure Python/Cython, fully compatible with CPython (\u003e3.6)\n\nAlthough most games I have tested seem to run without issues, there are still some open issues that would improve\nperformance and accuracy and probably make some hard to emulate games work or work better.\n* Several popular(ish) mappers are not implemented (along with lots of less popular ones)\n* Some fine timing is not quite right, which might cause issues in some sensitive games\n* This is not a cycle-accurate emulator, so sub-instruction level timing is not correctly emulated, and some parts of\n  other systems are not emulated in a cycle-correct way\n* See my [devnotes](devnotes.md) for known issues and planned work\n\nI would like to give huge thanks and kudos to everyone who contributed to the amazing [NESDev Wiki](wiki.nesdev.com)\nand all the other fantastic sources (most listed in the code), tests and forums for NES emulator development and 6502\nprogamming.  Without these resources it would have been impossible to develop this emulator.\n\n### Usage\n\nBasic usage:\n\n    from nes import NES\n    nes = NES(\"my_rom.nes\")\n    nes.run()\n\nFull set of options:\n\n    from nes import NES, SYNC_AUDIO, SYNC_NONE, SYNC_PYGAME, SYNC_VSYNC\n\n    nes = NES(rom_file,                  # the rom file to load\n              screen_scale=3,            # factor by which to scale the screen (NES screen is 256x240 pixels with overscan)\n              log_file=None,             # file to log to (logging is largely turned off by default and is exceptionally slow for high-volume parts of the system)\n              log_level=None,            # level of logging (logging is largely turned off by default)\n              opengl=False,              # use opengl for screen rendering\n              sync_mode=SYNC_AUDIO,      # audio / video sync mode  (one of SYNC_AUDIO, SYNC_NONE, SYNC_PYGAME, SYNC_VSYNC; see below)\n              verbose=True,              # whether to print out cartridge info at startup\n              show_nametables=False,     # shows the nametables alongside the main screen (for debug, not compatible with opengl=True)\n              vertical_overscan=False,   # show the top and bottom 8 pixels (not usually visible on CRT TVs)\n              horizontal_overscan=False, # show the left and right 8 pixels (often not visible on CRT TVs)\n              palette_file=None,         # supply a palette file to use; None gives default\n              headless=False,            # runs the nes in headless mode without the pygame screen being started\n              )\n\nSync mode controls how the framerate is controlled and synced to screen/audio.  The available modes are as follows:\n\n    SYNC_NONE = 0  # no sync: runs very fast, unplayable, music is choppy\n    SYNC_AUDIO = 1  # sync to audio: rate is perfect, can glitch sometimes, screen tearing can be bad\n    SYNC_PYGAME = 2  # sync to pygame's clock, adaptive audio: generally reliable, some screen tearing\n    SYNC_VSYNC = 3  # sync to external vsync, adaptive audio: requires ~60Hz vsync, no tearing\n\n\nPure python version:\n\n(This is purely for interest and comparison to the Cython version.  It is very slow, has no APU, is not up to date, has some (more) bugs than the cython version and has not been developed for a while.):\n\n    from nes.pycore.system import NES as pyNES\n    pynes = pyNES(\"my_rom.nes\")\n    pynes.run()\n\n\n\n### Screenshots\n\nHere are some screenshots of the emulator in action: Super Mario Brothers, Donkey Kong, MegaMan\n\n\u003cimg src=\"/img/mario.png\" height=\"300\"\u003e\n\u003cimg src=\"/img/donkeykong.png\" height=\"300\"\u003e\n\u003cimg src=\"/img/megaman.png\" height=\"300\"\u003e\n\n### Controls\n\nDefault keymap is:\n\n    Up, Left, Down, Right: W, A, S, D\n    Select, Start:  G, H\n    A, B: P, L\n\nOSD/Volume controls:\n\n    Turn off OSD:  1\n    Start CPU logging (very slow): 2\n    Volume Down/Up: -, =\n    Mute: 0\n\n\n\n### Dependencies\n\nDepends on the following libraries for key functionality:\n* numpy (optional?)\n  * headless operation\n  * (possibly also required by pygame surfarray, used in rendering)\n* pygame (optional)\n  * timing\n  * rendering\n  * input\n  * (without pygame, only headless operation is possible)\n* pyaudio (optional)\n  * audio playing\n  * sync to audio\n* pyopengl (optional)\n  * OpenGL rendering\n  * (not essential; can use SDL rendering via pygame)\n\n### License\n\nDistributed under the MIT License (see [here](LICENSE))","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fjameskmurphy%2Fnes","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Fjameskmurphy%2Fnes","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fjameskmurphy%2Fnes/lists"}