🎬 TermCinema CLI

Turn your terminal sessions into cinematic SVG animations — perfect for docs, blog posts, presentations, or just showing off your CLI aesthetics.

⚙️ Powered by termcinema-engine

🧱 Built in Rust · Embeddable via WebAssembly, Python (and more soon)

✨ Features

✅ Render shell-like text as animated SVG
🎨 9+ built-in retro & modern terminal themes
⌨️ Typing animation with speed presets or per-frame control
🔠 Custom font, color, layout, alignment
🧑‍🎨 Custom cursor (e.g. |, ▋, ⚡)
🔩 Embeddable as Rust/WASM library

📦 Installation

cargo install termcinema-cli

🚀 Usage

▶️ Basic

termcinema -i 'echo "Hi, TermCinema!"' -o out.svg

📜 From script file

termcinema -s ./demo.txt -o out.svg

🚰 Pipe Mode (Stdin)

echo "The quick brown fox..." | termcinema -o out.svg

🎨 Themes

termcinema -i "Hello" --theme "dos_classic"
termcinema --list-themes

🔡 Font Family

termcinema -i "Hello" --font-family "JetBrains Mono"
termcinema --list-fonts

Tested Monospaced Fonts

Font Name	Built-in?	Embeddable?	Notes
PxPlus IBM VGA8	❌	✅ Yes	Pixel-perfect retro feel
JetBrains Mono	❌	✅ Yes	Modern, developer-oriented
Fira Code	❌	✅ Yes	Monospaced font with programming ligatures
Source Code Pro	❌	✅ Yes	Clean and balanced, from Adobe
Cascadia Mono	❌	✅ Yes	Microsoft’s modern monospaced font
Courier New	✅ System	⚠️ Wide	Technically monospaced but visually outdated
Monospace (generic)	✅ System	⚠️ Unreliable	Often mapped to variable-width fonts

💡 Prefer the “✅ Yes” fonts above for best SVG alignment and retro aesthetics.

⚡ Speed Control

termcinema -i "Hello" --speed fast
termcinema -i "Hello" --frame-delay 120

🖼 Demo Gallery

Dive into 12+ terminal styles — Bash, Zsh, PowerShell, Python, Git, SQL, and more — all pre-rendered as cinematic SVG animations.

📂 Full demo files in examples/README.md

Terminal Style
🐧 Unix Shell
🍎 macOS Zsh
🪟 PowerShell
🐍 Python REPL
🟢 Node.js REPL
🌙 Lua REPL
❤️ Redis CLI
🐬 MySQL CLI
🐘 PostgreSQL CLI
🧬 Git Log
🌐 Switch Console
📜 Script Input

🧩 Use as Library

You can use this as a Rust library:

use termcinema_cli::{CliArgs, render_svg_direct};

let args = CliArgs {
    theme: Some("retro_tty".into()),
    ..Default::default()
};

let svg = render_svg_direct("echo hello", &args).unwrap();

See full API on docs.rs/termcinema-cli

🆘 Usage Help

Run termcinema --help
Or see docs/help.txt for full CLI options

termcinema-cli 0.1.0