LinuxCommandLibrary
GitHubF-DroidGoogle Play Store

termtosvg

Record terminal sessions as SVG animations

TLDR

Start recording (exit shell or Ctrl-D to stop)
$ termtosvg
copy
Record to a specific file
$ termtosvg [out.svg]
copy
Still frames instead of animation
$ termtosvg --still-frames [outdir]
copy
Render an asciicast
$ termtosvg render [recording.cast]
copy

SYNOPSIS

termtosvg [*output*] [*options*]termtosvg render *castfile* [*options*]

DESCRIPTION

termtosvg is a Unix terminal recorder written in Python that renders command-line sessions as standalone SVG animations (or still frames). Recordings are lightweight and embeddable on project pages. Custom colour themes and UI chrome are available via SVG templates. It can also render asciinema asciicast files.Install with pip3 install termtosvg (Python >= 3.5) or from distro packages. Invoke as termtosvg or python3 -m termtosvg.Maintenance status: as of June 2020 the upstream repository is read-only and unmaintained. Prefer asciinema plus other renderers for new projects if you need active support.

PARAMETERS

*output*

Output SVG path for a live recording (optional; default under a temp/generated name depending on version).
--still-frames [*dir*]
Export still frames instead of (or in addition to) animation, when supported.
render *file.cast*
Render an existing asciicast.
Template and geometry flags vary by version; see termtosvg --help and the templates man page in the repo.

INSTALL

nix profile install nixpkgs#termtosvg
copy

CAVEATS

Unmaintained since 2020. Unix-like systems only (Linux, macOS, BSD). SVG playback depends on the viewer; very long sessions produce large files. For actively maintained terminal recording, consider asciinema.

SEE ALSO

asciinema(1), script(1), ttyrec(1), vhs(1)

RESOURCES

Copied to clipboard
Kai