datastar-matrix

A realtime multiplayer, shared simulation of the matrix digital rain; simulitaneously rendered in the terminal and the browser.

What this is

This is an example of Datastar and Rust, built with Codex and OpenSpec.

• Rust simulation and terminal rendering with ratatui
• Axum SSE transport for frame streaming to modern browsers
• Datastar powered browser web interface
• HTTPS will use Brotli compression if available

Install

cargo install --path .

Run

Default HTTPS with auto-generated dev certificate:

datastar-matrix --port 40404

Insecure HTTP:

datastar-matrix --insecure --port 40404

Custom TLS cert/key:

datastar-matrix --tls-cert ./certs/dev-cert.pem --tls-key ./certs/dev-key.pem --port 40404

See full TLS notes in docs/local-tls.md.

Controls

• q: quit
• ?: toggle stats overlay
• + / -: speed up / slow down
• 0: reset speed
• space: pause/resume
• Left click: create a glitch in the matrix