This project has been discontinued in favour of a complete rewrite in Rust.
Original readme follows...
f-type is a work-in-progress emulator for Nintendo's 8-bit 6502 family of systems (NES, Family Computer, Vs. System, Playchoice-10). It is written entirely from scratch, using existing documentation available online.
- As platform-agnostic as possible, should compile and run on any platform supported by SDL2
- Mostly complete, mostly accurate NTSC/RGB PPU rendering
- Sound (very rough but implements all built-in channels)
- Regular controller input
- Lightgun input (via mouse)
- Mapper support:
- First-party: 0, 1, 2, 3, 4, 7, 9, 10, 13, 34, 66, 94, 99, 119, 155, 180, 185 (all except the MMC5 and some variants)
- Third-party: 11, 38, 39, 68, 70, 75, 79, 87, 89, 93, 97, 113, 140, 146, 151, 152, 184
- Debugger!
- GUI!
- ...and lots more
- SDL 2.0.x
- ...that's all for now
A simple Makefile is included, so assuming a Unix-style environment with properly installed dependencies, simply run make to build.
See the next sub-sections for platform-specific instructions.
Make sure you have the SDL2 development package installed via your distribution's package manager (libsdl2-dev on Debian/Ubuntu), then use the Makefile to build.
Install the dependencies via Homebrew:
$ brew install sdl2
In addition to the Makefile, an Xcode project is also included, although it still builds the "Unix way" which means no full-fledged application bundle for now.
NOTE: The Windows version lacks a standard output (so far). Drag and drop a ROM file to the executable to run it.
Precompiled binaries can be downloaded here (updated occasionally, might not be up to date).
Building for Windows is only supported via mingw-w64 for now (and only 32-bit is confirmed to work). Get the mingw development libraries from the SDL2 download page. To build with the Makefile, you'll probably need to override a few variables to specify the compiler and proper invocation of sdl2-config:
$ export SDL_PATH=<where you extracted SDL2-devel-2.0.x-mingw.tar.gz>/i686-w64-mingw32
$ make TARGET=f-type.exe CC=i686-w64-mingw32-gcc SDL2_CONFIG="$SDL_PATH/bin/sdl2-config --prefix=$SDL_PATH"
You will also need to copy SDL2.dll from $SDL_PATH/bin to the same directory as the executable.
f-type doesn't have any sort of GUI yet, so a iNES format ROM file (ie. .nes extension) must be specified as argument to the command-line.
If you are looking for free sample games to try it out, download the MegaPack at NES Homebrew Competition.
This project wouldn't be possible without the following sources: