🎬 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

💡 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

🧩 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

🔗 See Also

• Back to Project Overview
• docs.rs/termcinema-cli
• Changelog
• License