Support

RedEye VB is a Nintendo Virtual Boy emulator for Mac.

Getting Started

1. Install RedEye VB from the Mac App Store.
2. Acquire a .vb ROM you legally have rights to — your own backup, public-domain test ROMs, or homebrew from the Planet Virtual Boy community.
3. Open the App and choose File → Load ROM… (or drag a .vb file onto the window).

Controls

RedEye supports any MFi (Apple-licensed) game controller, plus a configurable on-screen and keyboard control scheme. To configure: Options → Configure Controller.

VB button	Default keyboard	Game controller
Left D-pad	↑ ↓ ← →	Left stick / D-pad
Right D-pad	I J K L	Right stick / face buttons
A	Z	A / Cross
B	X	B / Circle
L trigger	Q	L1 / LB
R trigger	E	R1 / RB
Start	Return	Menu / Options
Select	Right Shift	View / Share

Hotkeys

• F1 — cycle stereoscopic display mode
• F9 — start / stop video recording
• F10 — screenshot
• F11 — toggle fullscreen
• Tab (held) — fast-forward at 4×
• ` (backtick, held) — rewind in real time
• ⌘O — open ROM
• ⌘Q — quit

Save States

8 quick-save slots, accessible from File → Save State and File → Load State. SRAM (battery saves) for games that support them auto-load and save next to the ROM file.

Netplay

Two players on the same Wi-Fi network can play homebrew titles that use the Virtual Boy's link cable. Open Tools → Netplay, click Host; on the second Mac, choose Browse and pick the host. No internet servers are used.

Reporting a Bug

Open a bug report on GitHub

The form will ask for the ROM you were running, what happened, your macOS / RedEye versions, and any screenshots. A free GitHub account is required.

Feature Requests & Questions

• Suggest a feature
• Ask a question
• Browse existing issues

Privacy

See the Privacy Policy. Short version: nothing leaves your Mac except link-cable bytes during netplay, by your explicit choice.