Universal N64 flashcart menu for wide variety of devices
Go to file
Robin Jones 7b1cf8f2ed Update README.md
Improve Gamepak sprite info
2024-10-25 23:00:55 +01:00
.devcontainer Update docs for newer firmware (#143) 2024-09-30 22:21:39 +01:00
.github Updated doxygen action version 2024-10-25 19:36:04 +01:00
assets Add sound effects (#108) 2024-06-05 22:04:25 +02:00
docs Update 99_developer_guide.md 2024-10-23 16:12:49 +01:00
filesystem Use stdio calls for file/directory interaction instead of fatfs (#95) 2024-04-24 02:45:09 +02:00
libdragon@9dd994151a libdragon update + reorganized menu init + bug fixes 2024-09-17 00:11:51 +02:00
src Improve settings editor text 2024-10-25 19:27:06 +01:00
tools/sc64 Moved assets to the DragonFS 2023-12-08 19:49:50 +01:00
.clang-format clang-format WIP 2024-04-26 23:04:19 +02:00
.gitattributes Mark src/libs folder as vendored code 2023-07-26 12:43:18 +02:00
.gitignore Improve documentation (#128) 2024-08-04 17:56:54 +01:00
.gitmodules Use stdio calls for file/directory interaction instead of fatfs (#95) 2024-04-24 02:45:09 +02:00
Doxyfile Improve documentation (#128) 2024-08-04 17:56:54 +01:00
localdeploy.bat Added USB debug commands handling + file_get_sectors refactor 2023-09-04 21:09:46 +02:00
Makefile libdragon update + reorganized menu init + bug fixes 2024-09-17 00:11:51 +02:00
README.md Update README.md 2024-10-25 23:00:55 +01:00
remotedeploy.sh Added USB debug commands handling + file_get_sectors refactor 2023-09-04 21:09:46 +02:00

Build

N64 Flashcart Menu

An open source menu for N64 flashcarts.

Supported Flashcarts

Fully supported

  • SummerCart64
  • 64Drive

Work in Progress

  • ED64
  • ED64P

Current (notable) menu features

  • Fully Open Source.
  • Loads all known N64 games (including iQue and Aleck64 ROMs (even if they are byteswapped)).
  • Fully emulates the 64DD and loads 64DD disks (SummerCart64 only).
  • Emulator support (NES, SNES, GB, GBC) ROMs.
  • N64 ROM box image support.
  • Background image (PNG) support.
  • Comprehensive ROM save database (including HomeBrew headers).
  • Comprehensive ROM information display.
  • Real Time Clock support.
  • Music playback (MP3).
  • Menu sound effects.

Documentation

Video showcase (as of Oct 12 2023)

N64FlashcartMenu Showcase

Aims

  • Support as many N64 FlashCarts as possible.
  • Be open source, using permissive licensed third party licensed libraries.
  • Be testable, using unit and smoke tests in ares emulated environment.
  • Encourage active development from community members and N64 FlashCart owners.
  • Support as many common mods and features as possible.

Experimental features

These features are subject to change:

GamePak sprites

To use N64 GamePak sprites, place PNG files within the sd:/menu/boxart/ folder.

Supported sprites

These must be PNG files that use the following dimensions:

  • Standard N64 GamePak boxart sprites: 158x112
  • Japanese N64 GamePak boxart sprites: 112x158
  • 64DD boxart sprites: 129x112

They will be loaded by directories using each character (case-sensitive) of the full 4 character Game Code (as identified in the menu ROM information). i.e. for GoldenEye NTSC USA (NGEE), this would be sd:/menu/boxart/N/G/E/E/boxart_front.png. i.e. for GoldenEye PAL (NGEP), this would be sd:/menu/boxart/N/G/E/P/boxart_front.png.

To improve compatibility between regions (as a fallback), you may exclude the region ID (last matched directory) for GamePaks to match with 3 letter IDs instead: i.e. for GoldenEye, this would be sd:/menu/boxart/N/G/E/boxart_front.png.

Note1: Excluding the region ID may show the wrong boxart. Note2: For future support, boxart sprites should also include: boxart_back.png, boxart_top.png, boxart_bottom.png, boxart_left.png, boxart_right.png.

Compatibilty mode

If you cannot yet satisfy the correct boxart layout, The menu still has deprecated support for filenames containing the Game ID.

Note: This will add a noticeable delay for displaying parts of the menu.

Each file must be named according to the 2,3 or 4 letter GamePak ID (matched in this order). i.e.

  • for GoldenEye 4 letters, this would be sd:/menu/boxart/NGEE.png and/or sd:/menu/boxart/NGEP.png.
  • for GoldenEye 3 letters, this would be sd:/menu/boxart/NGE.png.
  • for GoldenEye 2 letters, this would be sd:/menu/boxart/GE.png.

As a starting point, here are some links to boxart packs:

Menu Settings

The Menu creates a config.ini file in sd:/menu/ which contains various settings that are used by the menu. If required, you can manually adjust the file on the SD card using your computer.

Flashcart specific

SC64

  • Ensure the cart has the latest firmware installed.
  • Download the latest sc64menu.n64 file from the releases page, then put it in the root directory of your SD card.

64drive

  • Ensure the cart has the latest firmware installed.
  • Download the latest menu.bin file from the releases page, then put it in the root directory of your SD card.

ED64 & ED64P

Currently not supported, but work is in progress (See PR's).

The aim is to replace Altra64 and ED64-UnofficialOS.

Open source software and licenses used

Sounds

See License for the following sounds: