Title: Feature Request: Add terminal session recording to Start-Transcript (capture TUI applications, export to video) · Issue #28353 · PowerShell/PowerShell · GitHub
Open Graph Title: Feature Request: Add terminal session recording to Start-Transcript (capture TUI applications, export to video) · Issue #28353 · PowerShell/PowerShell
X Title: Feature Request: Add terminal session recording to Start-Transcript (capture TUI applications, export to video) · Issue #28353 · PowerShell/PowerShell
Description: Summary Start-Transcript should gain the ability to record the terminal session itself — including full-screen interactive TUI applications — and save it in a replayable, time-stamped format (asciicast v3) optionally rendered as a video ...
Open Graph Description: Summary Start-Transcript should gain the ability to record the terminal session itself — including full-screen interactive TUI applications — and save it in a replayable, time-stamped format (ascii...
X Description: Summary Start-Transcript should gain the ability to record the terminal session itself — including full-screen interactive TUI applications — and save it in a replayable, time-stamped format (ascii...
Opengraph URL: https://github.com/PowerShell/PowerShell/issues/28353
X: @github
Domain: github.com
{"@context":"https://schema.org","@type":"DiscussionForumPosting","headline":"Feature Request: Add terminal session recording to Start-Transcript (capture TUI applications, export to video)","articleBody":"## Summary\n\n`Start-Transcript` should gain the ability to **record the terminal session itself** — including full-screen interactive TUI applications — and save it in a replayable, time-stamped format (asciicast v3) optionally rendered as a video file (GIF/WebM/MP4). This is the PowerShell-level equivalent of RHEL's system-wide session recording via `tlog`/SSSD/PAM, or of `asciinema`/`script(1)` — notably, the asciinema CLI itself [does not support Windows](https://github.com/orgs/asciinema/discussions/278).\n\n## Background\n\n`Start-Transcript` is documented to capture *\"all command that the user types and all output that appears on the console\"*, but in practice it only captures what flows through the PowerShell host. TUI applications bypass the pipeline entirely:\n\n- On Windows, `sconfig` (Windows Server) opens the console directly (`CONIN$`/`CONOUT$`), switches to raw mode, and paints the screen with VT sequences\n- On Linux, `nmtui` (RHEL), `vim`, `htop`, etc. open `/dev/tty` and use the alternate screen buffer\n\nSo a transcript of a session that uses a TUI application is effectively blank for the duration of that application. This was discussed in detail in discussion #28296, where @rhubarb-geek-nz confirmed the current behavior is best-effort and noted his [console-logger](https://github.com/rhubarb-geek-nz/console-logger) tool proves the technical approach on Windows: a pseudo-console (ConPTY) wrapper can both display **and** capture interactive programs.\n\n## Proposed behavior\n\n```powershell\nStart-Transcript -Path .\\audit\\session01 -RecordTerminal -RecordingFormat WebM\nsconfig # full-screen TUI — fully recorded\n# ... interact ...\nStop-Transcript\n```\n\nProduces:\n\n- `session01.txt` — the existing text transcript (unchanged)\n- `session01.cast` — time-stamped terminal stream ([asciicast v3](https://docs.asciinema.org/manual/asciicast/v3/)); always written as source of truth; plays with `asciinema play`\n- `session01.webm` — rendered video (GIF built-in; WebM/MP4 via `ffmpeg` when available)\n\nNew parameters (strictly additive, existing behavior untouched): `-RecordTerminal`, `-RecordingFormat` (`Asciicast|Gif|WebM|Mp4`), `-RecordInput` (keystroke capture, off by default due to secret-capture risk), `-RecordIdleTimeLimit`.\n\nTechnical approach: host-level capture — the console host attaches native child processes to a ConPTY (Windows) / PTY (Unix) pair, proxies the VT stream to the real terminal, and tees it with timestamps into the recorder. Only the host can do this transparently; a PSGallery module cannot intercept `CONIN$`/`CONOUT$`/`/dev/tty` traffic of arbitrary children.\n\n## Scenarios\n\n- **Audit/compliance**: defensible records of privileged interactive administration (sconfig, nmtui, vendor consoles), aligned with the tlog/SSSD precedent and extendable via Group Policy per RFC0041\n- **Support/incident response**: reproduce exactly what was on screen when a failure occurred inside a TUI app\n- **Training/docs/bug reports**: shareable GIF/WebM of a full session including TUI interactions\n\n## Status\n\n- An RFC draft has been submitted per the PowerShell RFC process: PowerShell/PowerShell-RFC#421\n- Discussion: #28296\n\nPer the RFC process, this issue requests the appropriate Working Group (WG-Interactive) to review whether the RFC can proceed toward an experimental implementation.\n\n/cc @rhubarb-geek-nz\n","author":{"url":"https://github.com/soroshsabz","@type":"Person","name":"soroshsabz"},"datePublished":"2026-11-05T15:41:06Z","url":"https://github.com/PowerShell/PowerShell/issues/28353"}
| react-profiling | 0 |
| react-import-map | react,react-dom,react-dom/client,react-dom/profiling,react-is,react/compiler-runtime,react/jsx-dev-runtime,react/jsx-runtime,scheduler@b8488ee2c322 |
| route-pattern | /_view_fragments/issues/show/:user_id/:repository/:id/issue_layout(.:format) |
| route-controller | voltron_issues_fragments |
| route-action | issue_layout |
| fetch-nonce | v2:c56bc85c-a07f-c2cb-26a8-7b6407f8074b |
| current-catalog-service-hash | 81bb79d38c15960b92d99bca9288a9108c7a47b18f2423d0f6438c5b7bcd2114 |
| request-id | D944:30AF58:1AFE065:25B98BE:6AFD014F |
| html-safe-nonce | 310afddcd7bc2e053966ce65b5f7c783342e894470a938cff86610a153be535d |
| visitor-payload | eyJyZWZlcnJlciI6IiIsInJlcXVlc3RfaWQiOiJEOTQ0OjMwQUY1ODoxQUZFMDY1OjI1Qjk4QkU6NkFGRDAxNEYiLCJ2aXNpdG9yX2lkIjoiODE2NzQ2NzgzOTg3MDA3ODIzIiwicmVnaW9uX2VkZ2UiOiJpYWQiLCJyZWdpb25fcmVuZGVyIjoiaWFkIn0= |
| visitor-hmac | a0a75a9cff3672f728955e0861ed03341c461ea06ce80c72503d334dd1244fdc |
| hovercard-subject-tag | issue:6226449920 |
| github-keyboard-shortcuts | repository,issues,copilot |
| google-site-verification | Apib7-x98H0j5cPqHWwSMm6dNU4GmODRoqxLiDzdx9I |
| octolytics-url | https://collector.github.com/github/collect |
| analytics-location | / |
| fb:app_id | 1401488693436528 |
| apple-itunes-app | app-id=1477376905, app-argument=https://github.com/_view_fragments/issues/show/PowerShell/PowerShell/28353/issue_layout |
| twitter:image | https://opengraph.githubassets.com/dadb67930e1cc448b67647a7f3b73e6716f764e7eb34f725f8b04da81ccb72bf/PowerShell/PowerShell/issues/28353 |
| twitter:card | summary_large_image |
| og:image | https://opengraph.githubassets.com/dadb67930e1cc448b67647a7f3b73e6716f764e7eb34f725f8b04da81ccb72bf/PowerShell/PowerShell/issues/28353 |
| og:image:alt | Summary Start-Transcript should gain the ability to record the terminal session itself — including full-screen interactive TUI applications — and save it in a replayable, time-stamped format (ascii... |
| og:image:width | 1200 |
| og:image:height | 600 |
| og:site_name | GitHub |
| og:type | object |
| og:author:username | soroshsabz |
| hostname | github.com |
| expected-hostname | github.com |
| None | cfabad6ee26d2b84c7afef4ae0cc71b8b692fb9d66f9f15997652ef991bfd3f4 |
| turbo-cache-control | no-preview |
| go-import | github.com/PowerShell/PowerShell git https://github.com/PowerShell/PowerShell.git |
| octolytics-dimension-user_id | 11524380 |
| octolytics-dimension-user_login | PowerShell |
| octolytics-dimension-repository_id | 49609581 |
| octolytics-dimension-repository_nwo | PowerShell/PowerShell |
| octolytics-dimension-repository_public | true |
| octolytics-dimension-repository_is_fork | false |
| octolytics-dimension-repository_network_root_id | 49609581 |
| octolytics-dimension-repository_network_root_nwo | PowerShell/PowerShell |
| turbo-body-classes | logged-out env-production page-responsive |
| disable-turbo | false |
| browser-stats-url | https://api.github.com/_private/browser/stats |
| browser-errors-url | https://api.github.com/_private/browser/errors |
| release | 35f85b78676038389558a41adf8d76e474592ede |
| ui-target | full |
| theme-color | #1e2327 |
| color-scheme | light dark |
| react-app-name | issues |
Links:
Viewport: width=device-width