PowerSession

Asciinema-compatible terminal session recorder for Windows

A port of asciinema for Windows, based on Windows Pseudo Console(ConPTY)

This is a new Rust implemented version. if you are looking for the C# implementation, please go to the C# version

Checkout A Demo

Installation

Cargo

cargo install PowerSession

Winget

winget install Watfaq.PowerSession

Scoop

scoop install powersession-rs

Usage

Get Help

PS D:\projects\PowerSession> PowerSession.exe -h
Usage: PowerSession [OPTIONS] <COMMAND>

Commands:
  rec     Record and save a session
  play    Play a recorded session
  auth    Authentication with api server (default is asciinema.org)
  upload  Upload a session to api server
  server  The url of asciinema server
  stream  Stream a live terminal session to the asciinema server
  help    Print this message or the help of the given subcommand(s)

Options:
  -l, --log-level <log-level>  can be one of [error|warn|info|debug|trace] [default: error]
  -h, --help                   Print help
  -V, --version                Print version

Record with a specific shell or startup arguments

Use -c / --command to choose the shell explicitly and include any startup arguments you need.

PowerSession.exe rec demo.cast --command "powershell.exe -NoLogo"
PowerSession.exe rec demo.cast --command "pwsh.exe -NoLogo"

Use a self-hosted asciinema server

Set the server URL once, then authenticate and upload as usual. The configured server is reused for auth, upload, and stream.

PowerSession.exe server https://asciinema.example.com
PowerSession.exe auth
PowerSession.exe upload demo.cast

Credits

• windows-rs

Supporters

• GitBook Community License