PuNES

<p align="center"> <img src="https://user-images.githubusercontent.com/14859058/132302943-a466d3d5-75c2-4bac-b0b2-7f0aeb8c058d.png" alt="puNES"/><br> </p> <h3 align="center">Qt-based Nintendo Entertainment System emulator and NSF/NSF2/NSFe Music Player</h3> <p align="center"> <a href="https://github.com/punesemu/puNES/releases/latest"> <img src="https://img.shields.io/github/release/punesemu/puNES.svg?label=latest%20release" alt="GitHub release"/> </a> <a href="https://github.com/punesemu/puNES/blob/master/COPYING"> <img src="https://img.shields.io/github/license/punesemu/puNES.svg" alt="License"/> </a> <a href="https://crowdin.com/project/punes"> <img src="https://badges.crowdin.net/punes/localized.svg" alt="Crowdin"/> </a> <a href="https://github.com/punesemu/puNES"> <img src="https://img.shields.io/github/languages/code-size/punesemu/puNES?style=flat" alt="GitHub code size in bytes"/> </a> <a href="https://www.codefactor.io/repository/github/punesemu/punes/overview/master"> <img src="https://www.codefactor.io/repository/github/punesemu/punes/badge/master" alt="CodeFactor"/> </a> <a href="https://repology.org/project/punes/versions"> <img src="https://repology.org/badge/tiny-repos/punes.svg" alt="Packaging status"/> </a> </p> <p align="center"> <a href='https://flathub.org/apps/details/io.github.punesemu.puNES'> <img width='180' height='60' alt='Download on Flathub' src='https://flathub.org/assets/badges/flathub-badge-en.svg'/> </a> </p>

:floppy_disk: Work in Progress (WIP) Builds

These executables are always updated to the latest commit:

• Linux AppImage : :link:x86_64
• Windows 32 bit : :link:OpenGL - :link:D3D9
• Windows 64 bit : :link:OpenGL - :link:D3D9

Notes:

• WARNING save states of version 0.110 or earlier are no longer compatible.
• Due to the many changes I'm making to the core of the emulator, new bugs may have been introduced, if you find that the roms no longer work properly compared to version 0.110, please let me know.
• 32 bit versions are Windows XP compatible.

:beer: Support

If you want buy me a beer :

Multilingual Support

A big thank you to everyone who contributed to the translations:

• Arabic
• Chinese
• English
• French
• German
• Hungarian
• Italian
• Polish
• Portuguese
• Russian
• Spanish
• Turkish

Help with Translations here

:camera: Screenshots

<p align="center"> <img src="https://github.com/user-attachments/assets/801b85b5-78e7-47b7-9430-4b0904f876a8" width="400" alt="puNES main window"/> <img src="https://github.com/user-attachments/assets/a05a88de-1feb-41e7-a531-13a4e6ba6937" width="400" alt="puNES NSF2 Player"/> <img src="https://github.com/user-attachments/assets/4da61eb7-349c-43ab-bc88-85f993e86cca" width="400" alt="puNES Slot Preview"/> <img src="https://github.com/user-attachments/assets/3a1a0a82-d3b5-4213-9f73-ec28461ce188" width="400" alt="puNES General Settings"/> <img src="https://github.com/user-attachments/assets/eb135545-a3d4-4ca1-91f9-4b49aafe3cef" width="400" alt="puNES Video Filters Settings"/> <img src="https://github.com/user-attachments/assets/9358391c-4a16-4eff-9610-d56cc18c647b" width="400" alt="puNES Cheat Editor"/> <img src="https://github.com/user-attachments/assets/61a152b9-3d82-46a5-8b85-322d0a908ade" width="400" alt="puNES Xbox360 Standard Controller Settings"/> <img src="https://github.com/user-attachments/assets/d4c9dccb-1394-44fe-9f7e-8736b4c9f548" width="400" alt="puNES PS4 Standard Controller Settings"/> <img src="https://github.com/user-attachments/assets/3f7e4550-a9cf-4319-83e5-a126cb079b37" width="800" alt="puNES Family BASIC Virtual Keyboard"/> <img src="https://github.com/user-attachments/assets/4df74b2a-7889-4cb5-948e-66360fd64707" width="800" alt="puNES Subor Virtual Keyboard"/> </p>

:keyboard: Configuration

To run in portable mode there is 3 distinct ways:

1. If the executable is in a folder containing the puNES.cfg file.
2. Rename the executable by adding the suffix _p.
   • Examples: punes.exe -> punes_p.exe or punes64.exe -> punes64_p.exe
3. Run the emulator with the "--portable" option.

To see a list of available command-line options, start puNES with the -h argument.

:electric_plug: Supported Mappers

| 0 | 1 | 2 | 3 | 4 | 5 | 6 | 7 | 8 | 9 | 10 | |-----|-----|-----|-----|-----|-----|-----|-----|-----|-----|-----| | 11 | 12 | 13 | 14 | 15 | 16 | 17 | 18 | 19 | 20 | 21 | | 22 | 23 | 24 | 25 | 26 | 27 | 28 | 29 | 30 | 31 | 32 | | 33 | 34 | 35 | 36 | 37 | 38 | | 40 | 41 | 42 | 43 | | 44 | 45 | 46 | 47 | 48 | 49 | 50 | 51 | 52 | 53 | | | 55 | 56 | 57 | 58 | 59 | 60 | 61 | 62 | 63 | 64 | 65 | | 66 | 67 | 68 | 69 | 70 | 71 | 72 | 73 | 74 | 75 | 76 | | 77 | 78 | 79 | 80 | 81 | 82 | 83 | | 85 | 86 | 87 | | 88 | 89 | 90 | 91 | 92 | 93 | 94 | 95 | 96 | 97 | | | 99 | 100 | 101 | | 103 | 104 | 105 | 106 | 107 | 108 | | | | 111 | 112 | 113 | 114 | 115 | 116 | 117 | 118 | 119 | 120 | | 121 | 122 | 123 | | 125 | 126 | | | | | | | 132 | 133 | 134 | | 136 | 137 | 138 | 139 | 140 | 141 | 142 | | 143 | 144 | 145 | 146 | 147 | 148 | 149 | 150 | 151 | 152 | 153 | | 154 | 155 | 156 | 157 | 158 | 159 | | | 162 | 163 | 164 | | 165 | 166 | 167 | 168 | | 170 | 171 | 172 | 173 | | 175 | | 176 | 177 | 178 | 179 | 180 | | 182 | 183 | 184 | 185 | 186 | | 187 | 188 | 189 | 190 | 191 | 192 | 193 | 194 | 195 | 196 | 197 | | 198 | 199 | 200 | 201 | 202 | 203 | 204 | 205 | 206 | 207 | 208 | | 209 | 210 | 211 | 212 | 213 | 214 | 215 | 216 | 217 | 218 | 219 | | | 221 | 222 | | 224 | 225 | 226 | 227 | 228 | 229 | 230 | | 231 | 232 | 233 | 234 | 235 | 236 | 237 | 238 | | 240 | 241 | | 242 | 243 | 244 | 245 | 246 | | 248 | 249 | 250 | | 252 | | 253 | 254 | 255 | 256 | | 258 | 259 | 260 | 261 | 262 | 263 | | 264 | 265 | 266 | 267 | 268 | 269 | | 271 | 272 | | 274 | | | | | | | | 281 | 282 | 283 | 284 | 285 | | 286 | 287 | 288 | 289 | 290 | 291 | 292 | | | 295 | | | 297 | 298 | 299 | 300 | 301 | 302 | 303 | 304 | 305 | 306 | 307 | | 308 | 309 | | 311 | 312 | 313 | 314 | 315 | | | | | 319 | 320 | | 322 | 323 | 324 | 325 | | 327 | 328 | 329 | | | 331 | 332 | 333 | 334 | 335 | 336 | 337 | 338 | 339 | 340 | | 341 | 342 | 343 | 344 | 345 | 346 | 347 | 348 | 349 | 350 | 351 | | 352 | 353 | 354 | 355 | 356 | 357 | 358 | 359 | 360 | 361 | 362 | | | | | 366 | | 368 | 369 | 370 | | 372 | | | 374 | 375 | | 377 | | | 380 | 381 | 382 | | 384 | | | 386 | 387 | 388 | 389 | 390 | | | 393 | 394 | 395 | | 396 | 397 | 398 | 399 | 400 | 401 | | 403 | 404 | | 406 | | | | 409 | 410 | 411 | 412 | 413 | 414 | 415 | 416 | 417 | | | | 420 | 421 | 422 | | | | | | 428 | | 429 | | 431 | 432 | 433 | 434 | | 436 | 437 | 438 | | | | | 442 | | | | 446 | 447 | | | | | 451 | 452 | | | 455 | 456 | 457 | | | | | | | | | | | | | | | 471 | | | | | | | | | | | 481 | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | 512 | 513 | | | 516 | | 517 | 518 | 519 | | 521 | 522 | | 524 | 525 | 526 | 527 | | 528 | 529 | 530 | | 532 | | 534 | | 536 | 537 | 538 | | 539 | 540 | 541 | | 543 | | | | 547 | | | | 550 | 551 | 552 | | 554 | 555 | 556 | 557 | 558 | 559 | 560 | | 561 | 562 | | 564 | | | | | | | |

:electric_plug: UNIF boards

1. 3D-BLOCK
2. 8-IN-1
3. 10-24-C-A1
4. 12-IN-1
5. 13in1JY110
6. 42in1ResetSwitch
7. 64in1NoRepeat
8. 70in1
9. 70in1B
10. 150in1A
11. 158B
12. 190in1
13. 212-HONG-KONG
14. 603-5052
15. 8157
16. 8237
17. 8237A
18. 11160
19. 22026
20. 22211
21. 43272
22. 60311C
23. 80013-B
24. 82112C
25. 411120-C
26. 810544-C-A1
27. 820561C
28. 830118C
29. 830134C
30. 830425C-4391T
31. 830752C
32. 831128C
33. 891227
34. 900218
35. A60AS
36. A65AS
37. AC08
38. AMROM
39. ANROM
40. AOROM
41. AX5705
42. AX-40G
43. BB
44. BJ-56
45. BOY
46. BS-5
47. BS-400R
48. BS-4040R
49. CC-21
50. CHINA_ER_SAN2
51. CITYFIGHT
52. CNROM
53. COOLBOY
54. COOLGIRL
55. CTC-09
56. CTC-12IN1
57. D1038
58. DANCE
59. DANCE2000
60. DRAGONFIGHTER
61. DREAMTECH01
62. DRIPGAME
63. EDU2000
64. EH8813A
65. F-15
66. FARID_SLROM_8-IN-1
67. FARID_UNROM_8-IN-1
68. FC-28-5027
69. FK23C
70. FK23CA
71. FS304
72. G-146
73. Ghostbusters63in1
74. GKCXIN1
75. GN-26
76. GS-2004
77. GS-2013
78. H2288
79. HP898F
80. HP2018-A
81. HPXX
82. JC-016-2
83. K-3006
84. K-3010
85. K-3033
86. K-3036
87. K-3046
88. K-3071
89. K-3088
90. KOF97
91. KO