RustedBytes - A BytePusher VM in Rust

RustedBytes-BytePuhser is a Rust implementation of the BytePusher Virtual Machine, a simple virtual computer architecture designed for demoscene programming and low-level system experimentation.

What is the BytePusher VM?

The BytePusher VM is a minimalist virtual machine, created to be easy to implement and understand. It is often used to produce demos, games, or visual and audio experiments, thanks to its deterministic architecture and directly accessible video/audio memory.

Main features of the BytePusher VM:

• 16 MB linear memory
• Color video framebuffer (typically 256x256 pixels)
• 8-bit audio
• No conditional instructions: only copy and jump operations

For more details on the BytePusher VM specification, see the references below.

Implementation

This project implements the BytePusher VM in Rust, using:

• minifb for window and video framebuffer management
• rodio for audio output
• clap for command-line argument parsing

The project structure is modular:

• cpu.rs: BytePusher CPU logic
• memory.rs: virtual memory management
• screen.rs: framebuffer rendering
• audio.rs: audio generation and output
• keyboard.rs: keyboard input handling
• vm.rs: virtual machine orchestration
• main.rs: application entry point

To run a BytePusher ROM:

cargo run --release -- <rom.ByptePusher>

References

• BytePusher specification (esolangs.org)
• BytePusher reference implementation (GitHub)
• minifb crate (docs.rs)
• rodio crate (docs.rs)