Repository navigation
Releases
armNES 1.4.1
armNES 1.4.1: a save fix for flash-save boards and a safer Quit hotkey.
What's new
- Flash saves (mappers 30 and 111). Every release up to 1.4 filled the flash save of UNROM 512 and GTROM games with $FF on first boot. UNROM 512 games with a battery showed only the backdrop colour, and GTROM games lost the first 8 KB of their program. If one of these games doesn't boot, delete its save: a save written by an earlier release still holds the bad data. Thanks to SundownerSport (#1).
- Quit Twice and Quit Hold (Controls, in the app). Hotkey + Start now quits only when pressed twice within 3 seconds, the second press held for a second. The game still gets a quick Hotkey + Start, for games that use Select + Start. Both can be changed or turned off.
armNES 1.4
armNES 1.4: the last slow boards catch up, picture layers and sound channels can be switched off, and run-ahead and netplay hold on every board.
Updated in place on 20 November 2026: the files below now also run mapper 355 more than twice as fast, without stepping each CPU cycle. If you downloaded 1.4 before, download it again.
What's new
-
Speed. 1.3 left a group of boards slower than the rest: MMC3-style boards with the background at $1000, the FCEUmm boards that stepped a counter every CPU cycle, multicarts reading their ROM through a handler, and a few others. They now run close to a plain cartridge. In a speed sweep of every NES game in my library, about 230 games took four to nine times the median frame time in 1.3. In 1.4 every game is within two and a half times the median.
Behind it:
- MMC3-family boards (MMC3, MMC6, RAMBO-1, FK23C, COOLBOY, UNL-8237) with the background at $1000 render whole tiles, and their IRQ is worked out ahead instead of checked every few dots.
- FCEUmm boards counting CPU cycles run their counters in batches, as the native boards have since 1.3: mappers 40, 42, 43, 50, 65, 67, 83, 105, 106, 142, 178, 222, 264, 303, 308, 330, 359, 368, 406, 417, 446, 451, 540, 548, 555, 561, 562, the FFE boards (6, 17), and FCEUmm's VRC2/4, VRC3, VRC6, VRC7, MMC1, H3001, FME-7 and J.Y. clones.
- Multicarts whose pages read plain ROM most of the time are mapped straight for the CPU (30, 59, 63, 134, 212, 227, 235, 288, 328, 332, 380, 422, 488, 519, 534, 539, 554, 585).
- Writes that can't change what the PPU fetches (work RAM, PRG banks, sound registers) no longer catch the PPU up.
- Mapper 355's PIC microcontroller reads the CPU's address bus itself and runs in batches up to its next port access, worked out from its own program, instead of every CPU cycle. Its games take 3.1 to 3.5 ms a frame on an RG353M (Cortex-A55 at 1.8 GHz), 7.8 before.
- MMC5 past its IRQ line, MMC5 with a silent pulse, KS-7030 (347), Yuxing (169), mappers 96, 165, 272, 394, 518 and a Dendy's idle lines after the picture.
-
Layer Selection (end of Video, off by default) shows switches for the background, the sprites in front of it and the sprites behind it. Channel Selection (end of Audio, off by default) shows a switch for Pulse 1, Pulse 2, Triangle, Noise, DMC and each voice of the cartridge's sound chip. They change only what's drawn and heard: the game sees every layer and channel, so it plays on the same, and a channel switched off keeps its volume for when it's back on.
-
Netplay with different sound settings. Save states no longer carry the sound output, which follows each player's volume and position settings. Players with different settings saved different states, so RetroArch turned its desync checks off when they joined.
-
Run-ahead goes the same way as without it on every board. Three didn't: 116 (the frame after a load could run on the frame before's hooks), 185 (its disabled CHR read 0 after a load) and 394 (a state from its MMC3 mode loaded over its J.Y. mode kept the wrong handlers; this also went wrong without run-ahead).
-
States across platforms. States of the FCEUmm VRC2/VRC4 boards (14, 116, 222, 351, 446) had a different size on x86-64, 64-bit ARM and 32-bit ARM, so a netplay client on another architecture went its own way after joining.
-
Fixes:
- Boards that watch the CPU's writes to $2007 (the FFE boards' CHR RAM lock, 195, 252/253, 544) now see them. On 544 a menu's text came out as blank tiles.
- KS-7030 (347) no longer lets writes into the ROM between its RAM areas.
- Mapper 355's PIC sees every address the CPU puts on the bus, RAM and registers included, as on the cartridge, not only its reads and writes from $4020.
- 272 and 394 follow the PPU's timing as the exact model does; 1.3 checked on them every 8 dots and was off.
- An MMC3 IRQ worked out from partway through a line's sprite fetches could come late. No game in my library showed it.
-
Everything else plays exactly as in 1.3, across all my NES and Disk System games.
Checked: every NES and Disk System game (picture, sound and RAM through 1800 frames with presses) plays as in 1.3 apart from the changes above, in Fast and on a 668-game set in Balanced. Run-ahead went the same way as without it on every game in my library before the last fixes, which don't change what a save state holds, and per mapper with changed accuracy, sound and layer settings. Netplay between an RG353M (64-bit and 32-bit RetroArch) and an x86-64 PC, each side hosting, joined with no CRC warning for games on the boards changed in this release.
Upgrading
- Save states from 1.3 load, except those of the FCEUmm VRC2/VRC4 boards (14, 116, 222, 351, 446), which may not.
- Games on 272 and 394 may play on slightly differently from a state, with their timing fix.
Downloads
| File | For |
|---|---|
armNES-x86_64.AppImage, armNES-aarch64.AppImage |
The standalone app on Linux |
armNES-arm64.apk |
The standalone app on Android |
armnes_libretro-1.4-*.zip |
RetroArch: NES, Famicom and Disk System games |
armnes_arcade_libretro-1.4-*.zip |
RetroArch arcade folders: MAME's VS. System and PlayChoice-10 sets |
The core zips come for x86-64, 64-bit ARM (aarch64) and 32-bit ARM (armv7).
See armNES 1.3 for the batched sound chips and the Sunsoft 5B's volume. The README covers options, controls, credits and licenses.
armNES 1.3
armNES 1.3: every board that stepped each CPU cycle now runs in batches, two to four times faster, and the Sunsoft 5B can be heard.
Updated in place on 20 November 2026: the files below now also batch the IRQ-only boards, the karaoke board and the NSF player, fix the J.Y. boards' IRQ timing and the 5B's volume. If you downloaded 1.3 before, download it again.
What's new
-
Every board that stepped its sound or IRQ counter every CPU cycle now runs in batches, as the Disk System has since 1.2. Stepping each cycle kept the whole core on its slow path, so these games cost two to four times a plain cartridge's frame. On an RG353M (Cortex-A55 at 1.8 GHz), ms a frame:
Board Mapper 1.2.1 1.3 VRC7 85 10.3 3.4 VRC6 24, 26 9.7 2.1 Sunsoft FME-7 with the 5B 69 9.9 2.5 Namco 163 19 10.9 2.4 MMC5 5 11.1 6.2 VRC4 21, 23, 25 4.2 2.0 VRC3 73 4.3 2.0 Jaleco SS88006 18 4.4 2.2 Bandai FCG 16, 153, 157, 159 4.3 1.6 J.Y. Company 90, 209, 211 5.0 2.9 Tengen RAMBO-1 64, 158 5.0 2.7 YM2413 karaoke 515 8.9 2.1 NSF player, a file that waits for its play timer 14.4 0.9 Mapper 127 and Konami's QTa adapter (547) are batched too. That leaves room on 1.5 GHz Cortex-A53 handhelds, where the busiest of these games could drop below 60 fps.
-
A program waiting for an interrupt in a jump to itself has those cycles skipped in one go, as polling loops on $2002 already were. NSF files gain most from it.
-
Sunsoft 5B: its three channels were about 8 dB too quiet and hard to hear next to the 2A03. The 5B's DAC is now its 5-bit, 1.5 dB-a-step curve (NESdev), and a channel at full volume is about 8 dB louder than a 2A03 square, as rainwarrior measured on a real 5B (Nestopia mixes it the same). The amplifier's compression at the loudest volumes isn't modelled; music at the volumes games use doesn't reach it.
-
J.Y. Company boards (90, 209, 211, 35) counting the PPU's A12 line raise their IRQ on time. It came late before, so some screens split a few lines off: among those games, 18 now match the exact timing model through the first 1800 frames and the rest run closer to it. RAMBO-1 (64) games run closer to it too.
-
A save state made before the first frame no longer loses a few CPU cycles when loaded. With run-ahead, a game could drift a few cycles from where it would have been without it.
-
Everything else plays exactly as in 1.2.1, across all my NES and Disk System games.
Netplay checked on an RG353M (64-bit and 32-bit RetroArch) with an x86-64 PC, each side hosting, with games for each of these boards and the Disk System: no state differences at any check.
Upgrading
- Save states from 1.2.1, 1.2 and 1.1 load. Games on J.Y. boards using A12, and on RAMBO-1, may play on slightly differently from a state, with the timing fix.
- Sunsoft 5B audio sounds louder: the chip is mixed at the level it has.
Known gaps
- The 41 boards that come from FCEUmm with a per-cycle counter still step each cycle. Their counters live inside FCEUmm's code; they're mostly pirate and multicart boards.
- Games that draw the background from the $1000 pattern table on an MMC3-style board, and NSF files whose code runs from $F000-$FFFF, stay slower than most.
Downloads
| File | For |
|---|---|
armNES-x86_64.AppImage, armNES-aarch64.AppImage |
The standalone app on Linux |
armNES-arm64.apk |
The standalone app on Android |
armnes_libretro-1.3-*.zip |
RetroArch: NES, Famicom and Disk System games |
armnes_arcade_libretro-1.3-*.zip |
RetroArch arcade folders: MAME's VS. System and PlayChoice-10 sets |
The core zips come for x86-64, 64-bit ARM (aarch64) and 32-bit ARM (armv7).
See armNES 1.2 for the cheat cartridges and the expansion sound fixes. The README covers options, controls, credits and licenses.
armNES 1.2.1
armNES 1.2.1: netplay keeps both players on the same Game Genie setting.
What's new
- Netplay: a player who joins gets the host's Game Genie setting for the session, on or off, so both sides run the same thing. Their own saved setting stays as it was. Each player needs the Game Genie in their own system folder (
[BIOS] Game Genie (USA, Europe) (Unl).unhorgamegenie.nes); no ROM is sent over the network. - Loading a save state also plugs the Game Genie in or out to match how the state was made.
Checked between x86-64 and 64-bit ARM, each side hosting, with the two set differently: the console's memory matched on both sides at every check.
Upgrading
- Save states from 1.2 and 1.1 load as before.
Downloads
| File | For |
|---|---|
armNES-x86_64.AppImage, armNES-aarch64.AppImage |
The standalone app on Linux |
armNES-arm64.apk |
The standalone app on Android |
armnes_libretro-1.2.1-*.zip |
RetroArch: NES, Famicom and Disk System games |
armnes_arcade_libretro-1.2.1-*.zip |
RetroArch arcade folders: MAME's VS. System and PlayChoice-10 sets |
The core zips come for x86-64, 64-bit ARM (aarch64) and 32-bit ARM (armv7).
See armNES 1.2 for the cheat cartridges, the expansion sound fixes and the Disk System speed-up. The README covers options, controls, credits and licenses.
armNES 1.2
armNES 1.2: cheat cartridges, expansion sound as NESdev documents it, and fast-forward for the Disk System.
What's new
- Cheat cartridges, run as themselves:
- The Game Genie option (Core Options › System) plugs the Game Genie in between the console and any cart game you load, its code screen first. The core finds it in the system (BIOS) folder: No-Intro's
[BIOS] Game Genie (USA, Europe) (Unl).unhorgamegenie.nes. The game stays the one you loaded, so its saves, save states and RetroArch's cheat lookup work as usual. - Datel's Pro Action Replay (v1.0, v1.1 and v1.2): load its ROM and pick the game with Game on Top. Its trainer works, and Reset brings its menu back with what it has learnt, as on the console. The Game Genie can be loaded the same way.
- Cheat Code 1 to 5 (3 on the Game Genie) put cheats from RetroArch's cheat database into the cartridge, as if typed on its screen. They're kept for each game.
- The Game Genie option (Core Options › System) plugs the Game Genie in between the console and any cart game you load, its code screen first. The core finds it in the system (BIOS) folder: No-Intro's
- Expansion sound fixed against NESdev's documentation:
- VRC7 plays the chip's own instruments. Before, every VRC7 game played the YM2413's, so Lagrange Point's bass was wrong.
- Namco 163 is as loud as its board's submapper says. MMC5's PCM, Disk System modulation, and Sunsoft 5B's envelopes are fixed too. VRC6 has its halt and frequency-scale register, VRC7 has only six channels, and so on.
- Each chip's voices have their own Volume and Position options (VRC6, VRC7, Sunsoft 5B, Namco 163, MMC5). They're shown only for the chip a game has.
- Disk System games run about as fast as cartridges (about four times faster than before), so fast-forward has room to work.
- Namco 163 carts that keep their save in the sound chip (Famista '90 among them) no longer lose it when the console restarts, as changing Region or Cart Jumper did.
Upgrading
- Save states from 1.1 load and play on exactly as before.
- Expansion-chip games sound different where the chips were fixed. That's the point of the change.
Known gaps
- The Fast PPU misses 15 of AccuracyCoin's 147 tests, on behavior no game is known to use. Balanced and Exact pass all 147.
- What a soft reset leaves in the APU's frame counter and length counters isn't quite right yet.
- Overclock gives games extra CPU time; a few misbehave with it.
- The Game Genie option isn't for Disk System games, NSF files or VS. System games.
Downloads
| File | For |
|---|---|
armNES-x86_64.AppImage, armNES-aarch64.AppImage |
The standalone app on Linux |
armNES-arm64.apk |
The standalone app on Android |
armnes_libretro-1.2-*.zip |
RetroArch: NES, Famicom and Disk System games |
armnes_arcade_libretro-1.2-*.zip |
RetroArch arcade folders: MAME's VS. System and PlayChoice-10 sets |
The core zips come for x86-64, 64-bit ARM (aarch64) and 32-bit ARM (armv7).
The README covers options, controls, credits and licenses.
armNES 1.1
armNES 1.1: faster, more accurate, with save fixes and steadier netplay.
What's new
- Faster, on handhelds as well as desktops.
- PPU Accuracy has three settings now: Fast (the default), Balanced, and Exact for desktops. Balanced passes all 147 AccuracyCoin tests and runs about as fast as Nestopia.
- Zapper: light now lasts as long as on real hardware, based on how bright the color is, and only from pixels drawn this frame. The crosshair inverts the picture under it, and the VS. System Zapper works. You can aim with the right stick (moving or pointing the crosshair), a light gun, the mouse, or the device's gyroscope or tilt, with invert options for either axis.
- Ports: Auto plugs in whatever device an NES 2.0 header names (Zapper, Power Pad or paddle) until you pick one.
- Saves (
.srm) fixed for several boards:- MMC1 carts with two RAM chips now save the battery-backed one.
- MMC6 now has its own 1 KB RAM with its read and write enables.
- Namco 175 RAM works, starting enabled at power-on.
- Namco 163 now keeps its sound RAM on the battery, like Mesen and Nestopia. It's saved after the cart RAM.
- Save states:
- Same layout on 32-bit and 64-bit builds.
- A loaded state saves back the same bytes. RetroArch netplay checks for this, so netplay between ARM and x86, or 32-bit and 64-bit, stays in sync.
- VRC7 and the karaoke board keep their FM chip's full state.
- Boards that use FCEUmm's code come back with every bank as it was.
- Re-releases that put emulator hooks in the game code (Virtual Console and collection builds) now run like the original carts.
- One unlicensed board now sets RAM at power-on the way Nestopia does, so the game on it boots.
- A few PPU fixes for
$2007reads. - Options have clearer names and help text, and the Zapper options have their own category. Saved settings carry over.
Upgrading
- Save states from 1.0 won't load for VRC7 games, the karaoke board, or boards that use FCEUmm's code. Other states still load.
.srmfiles from 1.0 may not carry over for the carts whose saves were fixed. Their old saves sat in the wrong place.- For netplay, both players need the same RetroArch version.
Known gaps
- The Fast PPU misses 15 of AccuracyCoin's 147 tests, on behavior no game is known to use. Balanced and Exact pass all 147.
- What a soft reset leaves in the APU's frame counter and length counters isn't quite right yet.
- Overclock gives games extra CPU time; a few misbehave with it.
Downloads
| File | For |
|---|---|
armNES-x86_64.AppImage, armNES-aarch64.AppImage |
The standalone app on Linux |
armNES-arm64.apk |
The standalone app on Android |
armnes_libretro-1.1-*.zip |
RetroArch: NES, Famicom and Disk System games |
armnes_arcade_libretro-1.1-*.zip |
RetroArch arcade folders: MAME's VS. System and PlayChoice-10 sets |
The core zips come for x86-64, 64-bit ARM (aarch64) and 32-bit ARM (armv7).
The README covers options, controls, credits and licenses.
armNES 1.0
The first release of armNES: an NES and Famicom emulator for ARM and x86 handhelds, as a libretro core and as a standalone app.
What's in it
- NES and Famicom games (
.nes,.unf), with hundreds of mappers, including unlicensed boards and multicarts, and cart jumpers and DIP switches. - Famicom Disk System games (
.fds), withdisksys.romin the system folder. - VS. System and PlayChoice-10 arcade games from MAME's sets, including DualSystem boards, through the
armnes_arcadecore or the app. - NSF music files.
- Accuracy where games can see it: the PPU draws each pixel at the cycle it would on the console, and the APU mixes as the console does, with the Disk System, VRC6, VRC7, MMC5, Namco 163 and Sunsoft 5B sound chips.
- A composite and S-Video filter that decodes the video signal as a TV of the time did, with optional scanlines.
- Save states, rewind, run-ahead, netplay, cheats and RetroAchievements.
- Zapper (light gun, mouse, right stick or touch), Arkanoid paddle, Power Pad, Four Score, the Famicom keyboard and microphone.
Downloads
| File | For |
|---|---|
armNES-x86_64.AppImage, armNES-aarch64.AppImage |
The standalone app on Linux |
armNES-arm64.apk |
The standalone app on Android |
armnes_libretro-1.0-*.zip |
RetroArch: NES, Famicom and Disk System games |
armnes_arcade_libretro-1.0-*.zip |
RetroArch arcade folders: MAME's VS. System and PlayChoice-10 sets |
Each core zip holds the core and its .info file. armnes leaves archives to RetroArch, so achievements recognize zipped games. armnes_arcade opens .zip and .7z itself, which MAME's sets need.
Known gaps
- The fast PPU games run on misses 19 of AccuracyCoin's 147 tests, on behavior no game is known to use; the cycle-exact PPU passes all 147.
- What a soft reset leaves in the APU's frame counter and length counters isn't quite right yet.
- Overclock gives games extra CPU time; a few misbehave with it.
See the README for the options, controls, credits and licenses.