> ## Documentation Index
> Fetch the complete documentation index at: https://sen-f208ff9e.mintlify.site/llms.txt
> Use this file to discover all available pages before exploring further.

# Session recording

> Record terminal sessions to asciicast files, replay them in the built-in player, and keep secrets out of the recording.

YourSSH records terminal sessions to [asciicast v2](https://docs.asciinema.org/manual/asciicast/v2/) (`.cast`) files. Use them for runbooks, demos or a record of what happened on a host.

## Start and stop a recording

Open an SSH or local terminal session and click **REC** at the top right of the terminal. While a session records, the button turns red and its tooltip reads **Stop recording** (it reads **Start recording** when idle). The status bar at the bottom shows a red `REC` timer.

![A terminal session with the REC button active and a 00:00:02 timer in the status bar](https://mintcdn.com/sen-f208ff9e/KwGOqbG40_L2ILah/images/03-first-connect/20-recording-active.png?fit=max\&auto=format\&n=KwGOqbG40_L2ILah\&q=85\&s=af2fd00da4c4235243da7dab3436268d)

A recording in progress: the REC button at the top right and the REC timer in the status bar.

Click the button again to stop. Closing the session also stops the recording. Recording isn't available for RDP and VNC tabs.

![The terminal after the recording stopped](https://mintcdn.com/sen-f208ff9e/KwGOqbG40_L2ILah/images/10-recordings/01-recording-stopped.png?fit=max\&auto=format\&n=KwGOqbG40_L2ILah\&q=85\&s=2669316dc65bf78dd78b02ef3487f370)

After stopping, the button returns to its idle state.

## Record every session of a host

To record a host every time you connect, turn on **Auto-record sessions** in the host editor ("Start recording automatically on connect"). See [Hosts](https://sen-f208ff9e.mintlify.site/user-guide/hosts.md).

## Redact secrets

YourSSH masks secrets before it writes them to the file, so a recording you share doesn't leak a password someone echoed mid-session. Each match is replaced with `[REDACTED]`. The patterns are the same ones the [audit log](https://sen-f208ff9e.mintlify.site/user-guide/audit-log.md) uses:

* `password=`, `token=`, `secret=` and `api_key=` style values, including prefixed forms such as `PGPASSWORD=`
* `Authorization: Bearer` tokens
* `sshpass -p`
* the attached `-p<password>` form of `mysql` and `mariadb`
* `redis-cli -a`
* passwords inside URLs (`scheme://user:pass@host`)

Redaction is on by default. You control it in two places:

* **Settings → Recording → Redact secrets in recordings** is the global switch.
* **Redact secrets in recordings** in a host's editor opts a single host out. It only has an effect while the global switch is on.

Local terminal recordings follow the global switch alone. YourSSH reads the setting when a recording starts, so changing it during a recording applies to the next one.

> [!WARNING]
>
> Redaction is a safety net, not a guarantee. A secret broken up by color codes, or one that doesn't match a known pattern, isn't caught. Also, YourSSH buffers output briefly so it can match secrets split across chunks, which makes replay timing per line rather than per keystroke.

## Recording library

Click **Recordings** in the sidebar to open the **Recording Library**. It groups recordings by host (for example `demo@127.0.0.1`) and shows each one's date and size. Click the refresh button at the top to rescan the folder.

![The Recording Library with one recording for demo@127.0.0.1](https://mintcdn.com/sen-f208ff9e/KwGOqbG40_L2ILah/images/10-recordings/02-library.png?fit=max\&auto=format\&n=KwGOqbG40_L2ILah\&q=85\&s=cd7e15af6905b0245673101123d48169)

The Recording Library lists recordings grouped by host.

Click a recording, or its play button, to open the player next to the list.

![The recording player with a timeline, play button and speed menu](https://mintcdn.com/sen-f208ff9e/KwGOqbG40_L2ILah/images/10-recordings/03b-player-playing.png?fit=max\&auto=format\&n=KwGOqbG40_L2ILah\&q=85\&s=cb006cf43c11c819e36ff88d444abba1)

The player replays the session in a terminal view.

| Control | What it does |
| - | - |
| Play / pause button | Starts or pauses the replay. |
| Timeline | Shows elapsed and total time. Drag or click it to seek. |
| Speed menu | Plays at `0.5x`, `1.0x`, `2.0x` or `5.0x`. |

Click the trash icon on a recording to delete it. YourSSH asks **Delete recording?** first, and the file is removed from disk.

![The Delete recording confirmation dialog](https://mintcdn.com/sen-f208ff9e/KwGOqbG40_L2ILah/images/10-recordings/04-delete-confirm.png?fit=max\&auto=format\&n=KwGOqbG40_L2ILah\&q=85\&s=342f832845db23d9c59e909a2f43e006)

Deleting a recording asks for confirmation.

## Where recordings are stored

Recordings go to the folder in **Settings → Recording → Recording path**. The default is `Documents/YourSSH/Recordings` in your home folder. Click **Change…** to pick another folder.

Each host gets a sub-folder, and each recording is named by its start time. Local terminals use a sub-folder named `local`.

```text theme={null}
<recording path>/<user>@<host>/session_YYYY-MM-DD_HH-mm-ss.cast
```

YourSSH creates the folders and files so only your user can read them (mode `700` and `600` on macOS and Linux), because a recording can contain sensitive output. Because the files are standard asciicast v2, you can also play them with the `asciinema` tool.

## Related pages

* [Terminal](https://sen-f208ff9e.mintlify.site/user-guide/terminal.md)
* [Audit log](https://sen-f208ff9e.mintlify.site/user-guide/audit-log.md)
* [Settings](https://sen-f208ff9e.mintlify.site/user-guide/settings.md)


This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.