Skip to content
Command Line Virtual Boy Flash Cart (FlashBoy) Programmer
Branch: master
Clone or download
Fetching latest commit…
Cannot retrieve the latest commit at this time.
Permalink
Type Name Latest commit message Commit time
Failed to load latest commit information.
ci
src
.gitignore
.travis.yml
CHANGELOG.md
Cargo.toml
Cross.toml
LICENSE.md
README.md

README.md

Command Line Virtual Boy Flash Programmer

Build Status GitHub release GitHub license Last commit Contact Me

prog-vb is a simple open source utility for programming your FlashBoy (Plus) development cart from the command line.

This utility is mostly useful for Virtual Boy programmers; the original programmer provided is a (closed sourced!) Windows-only GUI application. In my experience, I found the GUI broke my concentration when I had to open the GUI and click around to program my flash cart each time I made changes to my homebrew (of course I have worse concentration problems that prematurely "ended" my VB homebrew career :P).

In addition, Mac/Linux users may find this application useful, since I'm unaware of a Mac/Linux-based solution for FlashBoy. Releases can be found here.

Why did I make this? For fun, mostly. I wanted an excuse to write some Rust. And I've always wanted an open source version of the programmer :).

Usage

At present, prog-vb takes one mandatory command line argument- the ROM to flash to the cart. The ROM must have been padded to 2 Megabytes ahead of time. prog-vb will automatically detect whether a FlashBoy is present, so no need to mess with VIDs or PIDs.

Command line invocation is subject to change. The accepted arguments/usage is display if a user types prog-vb -h.

When running the program for the first time on Windows 10, it is possible that Windows Defender SmartScreen will block the app. As a workaround, click "More information" on the warning window, and there will be an option to run the program anyway. You should only need to do this once. There is not much I can do about this at present, as I don't have a code-signing certificate.

TODO

  • Developer Mode for quick flashing.
  • Unexpected responses from FlashBoy are handled by failing immediately, without a good error message. I've yet to determine what types of messages to expect if programming fails.
  • Do FlashBoy and FlashBoy Plus have different VID:PIDs?
You can’t perform that action at this time.