Skip to content
ghostshell

Export

Decrypt a central recording to a plaintext asciinema v2 cast with ghostshell export, ready for asciinema play or any other tool.

Central recordings are AES-256-GCM encrypted on disk — cat, strings, and grep show only ciphertext:

console
$ sudo strings /var/lib/ghostshell/alice/20260526T151022-1426734.cast | head -1 TTEC2 # magic prefix; the rest is ciphertext

ghostshell export decrypts a recording to a plaintext asciinema v2 cast:

console
$ sudo ghostshell export -o session.cast 20260526T151022-1426734 exported plaintext cast to session.cast # now asciinema-compatible
Flag Effect
-o <file> Output path for the plaintext cast

The exported file plays anywhere asciinema casts play:

bash
asciinema play session.cast
asciinema cat session.cast

When you need it

  • Sharing a session with someone who does not have root on the box
  • Feeding a recording into external tooling that expects standard casts
  • Archiving a specific session outside the central store

You do not need export just to view a session — play, search, and tail all decrypt transparently using the key at /var/lib/ghostshell/.ghostshell.key.

Warning: The exported file is plaintext. Everything the user saw and typed at the terminal — potentially including secrets echoed to the screen — is readable by anyone who can read the file. Treat exports with the same care as the store itself, and delete them when done.

Note: export requires root and, like all content-revealing commands, is gated by the optional playback password if one is set.

Source of truth: README on GitHub