romm-link

romm-link is an Unraid-first companion launcher for RomM.

It connects RomM to browser-accessible emulator containers such as:

• PCSX2
• RPCS3
• Dolphin

MVP scope

This MVP is intentionally simple:

• FastAPI backend
• Basic browser UI served from FastAPI
• Docker socket control for starting/stopping existing emulator containers
• Environment-variable based configuration
• Unraid template starter

What this MVP does not do yet

• It does not inject ROM files directly into emulators.
• It does not provide true WebRTC game streaming.
• It does not manage controller passthrough.
• It does not replace RomM.

Quick test

docker compose up --build

Open:

http://localhost:8787

Backend health:

http://localhost:8787/api/health

Environment variables

ROMM_URL=http://romm:8080
ROMM_API_KEY=
PCSX2_CONTAINER=pcsx2
RPCS3_CONTAINER=rpcs3
DOLPHIN_CONTAINER=dolphin
PCSX2_WEB_URL=http://192.168.1.200:3000
RPCS3_WEB_URL=http://192.168.1.200:3001
DOLPHIN_WEB_URL=http://192.168.1.200:3002

Unraid notes

This container needs access to:

/var/run/docker.sock

That allows romm-link to start and stop emulator containers.

First real milestone

The first real milestone is to make romm-link discover PS2, PS3, Wii and GameCube entries from RomM, then route each title to the matching emulator container.