TermSVG is an all in one cli tool to record, replay and export your terminal session to svg. It uses the same format as asciinema so you can convert asciicast files to SVG or use the asciinema player with a TermSVG recording.
You can download a pre compiled binary directly from the releases for your OS/Architecture.
go install github.com/mrmarble/termsvg/cmd/termsvg@latest # or target a specific version @v0.6.0
curl -sL https://raw.githubusercontent.com/MrMarble/termsvg/master/scripts/install-termsvg.sh | sudo -E bash -
# or with wget
wget -O - https://raw.githubusercontent.com/MrMarble/termsvg/master/scripts/install-termsvg.sh | sudo -E bash -
termsvg is composed of multiple commands, similar to git, docker or asciinema.
When you run termsvg with no arguments help message is displayed, listing all available commands with their options.
rec <filename>Record terminal session.
By running termsvg rec <filename> you start a new recording session. The command (process) that is recorded can be specified with -c option (see below), and defaults to $SHELL which is what you want in most cases.
You can temporarily pause recording of terminal by pressing Ctrl+P. This is useful when you want to execute some commands during the recording session that should not be captured (e.g. pasting secrets). Resume by pressing Ctrl+P again.
Recording finishes when you exit the shell (hit Ctrl+D or type exit). If the recorded process is not a shell then recording finishes when the process exits.
The resulting recording (called asciicast) is saved to a local file. It can later be replayed with termsvg play <filename> and/or exported to svg with termsvg export -i <filename>.
Available options:
-c, --command=<command> - Specify command to record, defaults to $SHELLplay <filename>Replay recorded asciicast in a terminal.
This command replays given asciicast (as recorded by rec command) directly in your terminal.
Playing from a local file:
termsvg play /path/to/asciicast.cast
Available options:
-i, --idle-time-limit=<sec> - Limit replayed terminal inactivity to max <sec> seconds-s, --speed=<factor> - Playback speed (can be fractional)For the best playback experience it is recommended to run
termsvg playin
a terminal of dimensions not smaller than the one used for recording, as
there's no "transcoding" of control sequences for new terminal size.
export <filename>Export recorded asciicast to svg.
This command exports given asciicast (as recorded by rec command) to svg.
Exporting from a local file:
termsvg export /path/to/asciicast.cast
Available options:
-o, --output=<file> - Output svg to be created. Defaults to [input].svg-m, --minify - Minify svg using MinifyLast modified 11 October 2025