Skip to content

Repository files navigation

Orbiter v0.1

Orbiter is an immersive NES emulator, introspector, and debugger for Windows, focused on providing a bad-ass debugging experience.

We don't just want to debug the machine. We want to see it breathe, hear its heartbeat, and feel its tender pulses.

Orbiter

The emulator and debugger grew together, so introspection is not an attachment: it is the point. Orbiter combines game playback with live disassembly, CPU and PPU inspection, execution-flow visualization, profiling, rewind, screenshots, video capture, and a persistent game library.

This is an early prerelease. Emulator compatibility is still a work in progress, and you should keep a copy of any library data you care about.

Getting started

  1. Extract the complete archive to a writable folder. Do not run Orbiter directly from the ZIP or install it under a read-only directory.
  2. Run Orbiter.exe.
  3. Press Ctrl+O to import an iNES .nes file.
  4. Press F5 to run or pause the game.
  5. Press Tab to open or close the game library.

Orbiter does not include game ROMs. Only use ROM images you are legally permitted to use.

Key bindings

Controller

InputKey
D-padArrow keys or WASD
AZ
BX
StartC
SelectV

Emulation and debugging

ActionKey
Run or pauseF5
Step one instructionF10 (hold to repeat)
Rewind / advance timelineCtrl+Left / Ctrl+Right
ResetCtrl+R
Save / restore the active resume pointCtrl+S / Ctrl+L
Dump the current programCtrl+K

Views and panels

ActionKey
Show controlsF1
Toggle game libraryTab
Import ROMCtrl+O
Video / Program / CPU1 / 2 / 3
Profiler / Execution Flow / CHR Map4 / 5 / 6
Split the focused panelCtrl+H / Ctrl+V
Close the focused panelCtrl+Q
Increase / decrease UI font sizeCtrl++ / Ctrl+-
Reset UI font sizeCtrl+0

Display, audio, and capture

ActionKey
Toggle fullscreenF11 or Alt+Enter
Toggle game-view fullscreenF
Leave game-view fullscreenEsc
Toggle CRT effectF7
MuteM
Raise / lower volumeCtrl+Up / Ctrl+Down
Take game screenshotF8
Start / stop game GIF captureShift+F8
Take application screenshotF9
Toggle UI debug boundsF6

Screenshots and game captures are written to the data directory. The active game is also saved when switching games and when Orbiter exits normally.

Compatibility

  • Windows 8 or newer, x64
  • iNES cartridges using mapper 0 (NROM), 1 (MMC1), 2 (UxROM), or 9 (MMC2)
  • Trainers and four-screen mirroring are not currently supported

Unsupported or malformed cartridges are rejected rather than partially loaded.

Building

Orbiter currently builds with Clang on Windows. From an x64 Developer Command Prompt, run:

build.bat

Local data

Orbiter stores its library, saves, configuration, logs, screenshots, and captures in the data directory beside the executable. The distributed archive contains none of those user files. The prerelease executable is unsigned, so Windows may show a security warning on first launch.

Orbiter is licensed under the MIT License. See THIRD_PARTY_NOTICES.md for the software and assets it uses.

About

NES emulator and debugger for Windows with live disassembly, execution tracing, profiling, and deterministic rewind.

Topics

Resources

Stars

13 stars

Watchers

0 watching

Forks

Releases

Packages

Contributors

Languages