README.md

metadata

title: HF Terminal
colorFrom: green
colorTo: gray
sdk: docker
pinned: false

HF Terminal

Real Bash shell in your browser via WebSocket + PTY. CRT-style skeuomorphic UI with scanlines, phosphor glow, and screen curvature.

Features

• Real Bash shell — supports nano, vim, htop, full ANSI colour
• WebSocket transport — zero polling, instant keystrokes
• Skeuomorphic CRT UI — scanlines, glow, curvature, flicker
• Three phosphor modes — Green, Amber, White
• Persistent bash history to /data

Architecture

Layer	Technology
Backend	Python 3.11 + Tornado (HTTP + WebSocket)
PTY	pty.fork() + non-blocking select()
Frontend	xterm.js 5.3 (CDN), vanilla JavaScript
Styling	Hand-crafted CSS — no frameworks
Container	Docker (Debian slim + common CLI tools)

Controls

Control	Description
Phosphor	Switch between Green, Amber, and White phosphor
Scanlines	Toggle CRT scanline overlay
Glow	Toggle text glow and bloom effect
Curvature	Toggle CRT screen curvature effect
Bell	Toggle audible bell on \x07 (default: off)

Keyboard shortcut: Ctrl+Shift+K clears the terminal buffer.

License

MIT