Skip to content

Session Recording

OxideTerm can record your terminal sessions to asciicast v2 (.cast) files — the open standard used by asciinema. Recordings capture every character of output with accurate timestamps, letting you replay sessions frame-by-frame or share them with teammates.

Click the record button (⏺) in the terminal toolbar, or use the command palette (⌘K → “Record Session”).

The recording starts immediately. The toolbar shows:

  • REC indicator (red dot) while recording
  • Elapsed time — running clock of the recording duration
  • Event count — number of captured output events
ActionButton / Shortcut
PauseClick ⏸ in toolbar
ResumeClick ▶ while paused (shows “PAUSED” indicator)
Stop & SaveStop recording and choose a destination for the .cast file
DiscardUse the recording menu to discard the current recording

Stopping opens a file picker for the recording. Discarding drops the in-memory recording without creating a file.

After saving, click Open Cast File to open it in the built-in player. You can also open any .cast file from the File Manager.

ControlDescription
Play / PauseStart or pause playback
Seek barDrag to jump to any point in the recording
SpeedAdjust playback speed (0.5× / 1× / 2×)
DurationTotal recording length
DimensionsTerminal grid size at time of recording (e.g., 220×55)

Type in the search box to find text in the recording:

  • Shows match count (e.g., “12 matches”)
  • Use Jump to match to seek to each occurrence
  • Useful for locating specific commands or error messages in long recordings

.cast files are plain JSON — one JSON object per line (JSON Lines format):

{"version": 2, "width": 220, "height": 55, "timestamp": 1711700000, "env": {"TERM": "xterm-256color"}}
[0.123, "o", "$ ls -la\r\n"]
[0.456, "o", "total 48\r\ndrwxr-xr-x 5 user group ..."]

This format is compatible with:

  • asciinema.org — upload and share online
  • asciinema-player — embed in web pages or README files
  • asciinema play CLI — play back in your local terminal

Manual .cast recording is separate from Notifications & Audit → Session recordings. To collect output automatically, first enable Audit, then enable Record terminal output and accept its prompt. Both switches start off.

Audit recordings contain displayed output and terminal-size changes, not typed keys or terminal file-transfer payloads. Shell-echoed input can still appear. They are encrypted on this device and excluded from cloud sync. Refresh the recordings list to play a session; incomplete or expired-content indicators mean some output is unavailable. Default terminal-output retention is 7 days with a 2 GiB capacity. Configure retention and capacity in that view and save the changes.

Manual .cast exports remain plaintext files in the location you choose.

The recording is stored only on your local machine in the path you choose. OxideTerm never uploads or transmits recording data anywhere.