inteintegrity2026-11-19

DOOM on reComputer RK3576: Browser Gaming with FlipCTL

Play DOOM with Freedoom game data on reComputer RK3576 through FlipCTL. Prepare a Bookworm-compatible ARM64 AppImage and control it from a PC browser.

DOOMFlipCTLGamingGitHub

Project Result

Run DOOM on reComputer RK3576 and control it from a PC browser with FlipCTL. The setup script prepares FlipCTL, its build tools, and a Bookworm-compatible DOOM application, so you do not need to complete another project first.

The game uses the dsda-doom engine and Freedoom levels; commercial DOOM WAD files are not required.

DOOM on reComputer RK3576 controlled with FlipCTL

Requirements

ItemRequirement
DevicereComputer RK3576
SystemARM64 Armbian based on Debian Bookworm, glibc 2.36
Board accountA regular Linux user with sudo access
PCSSH client and web browser
NetworkAccess to GitHub, Rust downloads/crates, and Debian package repositories; configure a proxy on the board if needed

Commands use seeed as the example username. Replace <BOARD_IP> with the board's actual IP, without the angle brackets.

Step 1: Prepare the Software

Connect from your PC terminal:

powershell
ssh seeed@<BOARD_IP>

In the board's SSH terminal, download, verify, and run the setup script:

bash
sudo apt update && sudo apt install -y curl ca-certificates &&
curl -fL --retry 3 --connect-timeout 20 --max-time 120 -o setup-doom-rk3576.sh \
  https://github.com/inteintegrity/doom-rk3576/releases/download/v0.2.0/setup-doom-rk3576.sh &&
printf '%s  %s\n' \
  c961924e97284eb04d480d036a6f70ca44ab38276634bea35edb97f87b13f3db \
  setup-doom-rk3576.sh | sha256sum -c - &&
bash setup-doom-rk3576.sh

The script installs dependencies, prepares Rust when needed, builds the pinned FlipCTL source, checks the packaging tools, and installs DOOM. Enter your sudo password if prompted. The first build can take some time; continue when the script prints Ready.. Do not continue if a checksum check or installation step fails.

Step 2: Connect the Remote Interface

If FlipCTL is already listening on the board's port 8899, reuse it. Otherwise, start it in the board terminal and keep that terminal open:

bash
cd ~/flipper-test/flipctl-slint
WLR_RENDERER=pixman ./target/release/flipctl \
  --headless \
  --remote 127.0.0.1:8899 \
  --assets "$PWD/crates/flipper-ui/assets/remote"

Open a separate PC terminal and create the tunnel below. Reuse an existing working tunnel instead of opening a duplicate:

powershell
ssh -N -o ExitOnForwardFailure=yes -o ServerAliveInterval=30 -L 127.0.0.1:8899:127.0.0.1:8899 seeed@<BOARD_IP>

Keep the tunnel window open. -N does not open an interactive shell. Open http://127.0.0.1:8899 in the PC browser and wait for Status: connected.

Step 3: Start Playing

Enable Show controls, press X to open Menu, choose Apps → Games → Doom, and press Enter. Wait for the actual Freedoom game scene, including the weapon and status bar.

Click an empty area of the page before using the keyboard; the on-screen buttons also work.

KeyActionKeyAction
↑ / ↓Move forward / backward← / →Turn
ZFireXNext weapon
VUse / open doorBMap
AOpen / close game menuEnterConfirm
TabApp switcherEsc / BackspaceReturn / background the app

Before reinstalling, close Doom in the app switcher: press Tab, select Doom, then press Z (Kill). Returning with Esc alone leaves the app in the background.

The setup uses a Bookworm-compatible engine and application-specific Mesa software rendering. The remote panel is 256×144 pixels; enlarging it changes its display size, not its original detail.