RetroBox

EmulatorJS-based retro gaming frontend with remote controller support.

Prerequisites

• Bun (for local development)
• Docker (for containerized deployment)
• EmulatorJS directory
  • Note: this has been modified to support decoupled screen/controller architecture (source uploaded upon request)

Running Locally

bun run server.ts

Server runs at http://localhost:3333

Running with Docker

docker build -t retrobox .

docker run -d --name retrobox -p 3333:3333 \
  -e HOST_IP=$(ipconfig getifaddr en0) \
  -v $(pwd)/EmulatorJS:/app/EmulatorJS \
  -v $(pwd)/presets:/app/presets \
  retrobox

Note: HOST_IP is required on macOS so LAN devices can discover the correct IP.
On Linux, use hostname -I | awk '{print $1}' instead.