tailpipe #

An SSH server that plays back terminal recordings in asciinema .cast format (both v2 and v3 supported).

ssh demo@your-server -p 4242

Controls #

• Space — pause/resume
• Left/Right — seek backward/forward
• o — toggle overlay
• q / Ctrl-C — quit

Configuration #

[server]
port = 4242
host_key = "/etc/tailpipe_ed25519.key"  # optional, generates ephemeral key if omitted
host_key_rsa = "/etc/tailpipe_rsa.key"  # optional, generates ephemeral key if omitted
header = "/srv/casts/header.cast"       # played before every session
footer = "/srv/casts/footer.cast"       # played after every session

[user.demo]
castfile = "/srv/casts/demo.cast"

[user.custom]
castfile = "/srv/casts/custom.cast"
header = "none"                         # skip header/footer for this user
footer = "none"

[user.default]                          # fallback for unknown usernames
castfile = "/srv/casts/default.cast"

Usage #

tailpipe [config.toml]

Defaults to tailpipe.toml in the current directory.

Credits #

• SSH server possible thanks to russh
• asciinema's rust code was a delight to read, and super helpful
• ratatui for the pause overlay UI