Convert asciinema terminal recordings into sharp, animated SVG files for easy sharing.
svg-term-cli is a Node.js command-line utility that converts asciinema terminal session recordings (asciicasts) into animated SVG files. It addresses the need for high-quality, embeddable terminal demos in documentation and READMEs, where GIFs often appear blurry and JavaScript players are unsupported.
Developers, technical writers, and open-source maintainers who create documentation or project READMEs and want to showcase terminal interactions with crisp, scalable animations.
It provides lossless, vector-based animations that are easy to share across platforms, offers styling flexibility with terminal color profiles, and integrates seamlessly with asciinema's ecosystem for a streamlined recording-to-embed workflow.
Share terminal sessions via SVG and CSS
Open-Awesome is built by the community, for the community. Submit a project, suggest an awesome list, or help improve the catalog on GitHub.
Produces razor-sharp SVG animations that scale perfectly, unlike blurry GIFs, as shown in the parrot example that remains crisp when zoomed.
Animations work anywhere SVG is supported, such as GitHub READMEs, without relying on external players or scripts.
Supports common terminal color profiles (e.g., iTerm2, Xresources) via --term and --profile options to match your setup.
Accepts asciicast IDs from asciinema.org, local JSON files, or stdin, enabling integration with various recording workflows.
Tied to the asciinema ecosystem for recording and hosting; if asciinema.org is down or you use other tools, conversion isn't possible.
Requires separate installations of asciinema and Node.js/npm, adding steps compared to all-in-one solutions or simple GIF recorders.
Long or complex terminal sessions can generate large SVG files, potentially slowing down page loads in documentation without manual trimming (e.g., using --from/--to).