marionebl

svg-term-cli: Turn Terminal Recordings into Animated SVGs

svg-term-cli converts asciinema recordings into animated SVGs that can be shared where JavaScript players are unavailable. It is a focused Node.js command-line tool, but its inactivity and concentrated contributor base are worth weighing before adoption.

InactiveJavaScriptMITCLITerminalAsciinema
View on GitHub Compare
Stars
4.2k
Forks
133
Stars, last 30 days
+4
Last commit
2.5 years ago
Contributors
5

Our take

Inactiveno commits in over a year

Health score

21/100

How it is scored
Activity
17
Community
26
Issues
21
Pull requests
20

+4 stars in the last 30 days

This is a narrowly useful conversion tool whose straightforward output format is offset by prolonged inactivity and a codebase concentrated around one contributor.

Good fit if

  • You already use asciinema and need a shareable animated SVG for documentation or package pages.
  • Your workflow can use a Node.js CLI and you are comfortable relying on a project with no recent commits or releases.
  • MIT-licensed software fits your distribution requirements.

Look elsewhere if

  • You need an actively maintained tool, given the absence of commits and releases in over a year.
  • Your project requires responsive issue or pull request handling, as none were closed or merged recently.
  • You need a recording tool rather than a renderer, since this project converts casts and expects asciinema for recording.
All health signals
Last commit2024-05-01 (2.5 years ago)
Commits, last 90 days0
Contributors5 (top contributor: 89% of commits)
Issues closed, last 90 days0
Pull requests merged, last 90 days0
Project age8 years

Checked on 2026-10-14 with the GitHub API.

Project history

Daily GitHub snapshots since Oct 7, 2026. History covers stars and forks; health signals are not tracked historically.

Selected snapshot

Stars

4,249

Forks

134

Change since Nov 17, 2026: 0 stars·0 forks

Overview

svg-term-cli renders asciinema terminal recordings as animated SVGs, including optional terminal window decorations. The result can be embedded in places such as GitHub READMEs or npm pages where an interactive asciinema player may not work, while keeping terminal text sharp when scaled.

It is aimed at developers who already record sessions with asciinema and want a portable visual demonstration without relying on a JavaScript player.

Key Features

  • Converts asciinema casts to animated SVG files.
  • Accepts a cast ID, an input JSON file, or recording data through standard input.
  • Selects a time range or a specific timestamp to render.
  • Sets output dimensions, padding, and cursor visibility.
  • Adds optional terminal window decorations.
  • Uses terminal color profiles from supported formats.
  • Can optimize generated SVGs, with an option to disable optimization.

Use Cases

  • A maintainer can embed a terminal walkthrough in a GitHub README where an interactive player is unavailable.
  • A CLI developer can add a scalable demo to an npm package page without publishing a GIF.
  • A technical writer can select a portion of a longer asciinema recording for documentation.
  • A team can show terminal output in a presentation or web page that supports SVG but not the asciinema player.

What you need

Detected in the repository

  • Node.js (from package.json)

License in plain words

MITpermissive

  • Commercial use: yes
  • Modify and redistribute: yes
  • You must keep: the copyright and license notice
  • Share your changes: no

A summary, not legal advice: the LICENSE file is what applies.

Getting Started

Install asciinema first, then install the CLI:

npm install -g svg-term-cli
svg-term --cast=113643 --out=demo.svg --window

See the repository README for the full command options and input methods.

Considerations

The project is marked inactive, with no commits in over a year and no releases during the last year. Although five contributors are recorded, most of the code comes from one person; recent issue closures and pull request merges are also absent. Plan to assess whether the existing CLI meets your needs and whether you can maintain or replace it if problems arise. The README describes asciinema as a separate installation prerequisite, and the project requires Node.js. It does not provide a Docker setup, CI configuration, or tests in the supplied project facts.

Found this useful?

Share it with someone who would like svg-term-cli.

Comparisons