dev6-ai/pi
1
0
Fork 0
Code Issues Pull requests Actions Packages Projects Releases Wiki Activity
pi/examples/extensions/doom-overlay
History
dev6-ai 6359ee255f PI coding agent source (initial)
2026-08-23 20:19:25 -04:00
..
doom PI coding agent source (initial) 2026-08-23 20:19:25 -04:00
doom-component.ts PI coding agent source (initial) 2026-08-23 20:19:25 -04:00
doom-engine.ts PI coding agent source (initial) 2026-08-23 20:19:25 -04:00
doom-keys.ts PI coding agent source (initial) 2026-08-23 20:19:25 -04:00
index.ts PI coding agent source (initial) 2026-08-23 20:19:25 -04:00
README.md PI coding agent source (initial) 2026-08-23 20:19:25 -04:00
wad-finder.ts PI coding agent source (initial) 2026-08-23 20:19:25 -04:00

README.md

DOOM Overlay Demo

Play DOOM as an overlay in pi. Demonstrates that the overlay system can handle real-time game rendering at 35 FPS.

Usage

pi --extension ./examples/extensions/doom-overlay

Then run:

/doom-overlay

The shareware WAD file (~4MB) is auto-downloaded on first run.

Controls

Action Keys
Move WASD or Arrow Keys
Run Shift + WASD
Fire F or Ctrl
Use/Open Space
Weapons 1-7
Map Tab
Menu Escape
Pause/Quit Q

How It Works

DOOM runs as WebAssembly compiled from doomgeneric. Each frame is rendered using half-block characters (▀) with 24-bit color, where the top pixel is the foreground color and the bottom pixel is the background color.

The overlay uses:

  • width: "90%" - 90% of terminal width
  • maxHeight: "80%" - Maximum 80% of terminal height
  • anchor: "center" - Centered in terminal

Height is calculated from width to maintain DOOM's 3.2:1 aspect ratio (accounting for half-block rendering).

Credits