asciinema-convert - Man Page

asciinema convert [-f|--output-format] [--overwrite] [-q|--quiet] [-h|--help] <INPUT> <OUTPUT>

Convert a recording to another format.

Transform asciicast files between different formats (v1, v2, v3) or export to other formats like raw terminal output or plain text. Supports reading from files, URLs, or stdin and writing to files or stdout.

-f,  --output-format <FORMAT>

Specify the format for the converted recording. The default is asciicast-v3. If the output file path ends with .txt, the txt format will be selected automatically unless this option is explicitly specified.

Possible values:

• asciicast-v3: Full-featured session format, with timing and metadata (current generation) - https://docs.asciinema.org/manual/asciicast/v3/
• asciicast-v2: Full-featured session format, with timing and metadata (previous generation) - https://docs.asciinema.org/manual/asciicast/v2/
• raw: Raw terminal output, including control sequences, without timing and metadata
• txt: Plain text without colors or control sequences, human-readable

--overwrite

Overwrite the output file if it already exists. By default, asciinema will refuse to overwrite existing files to prevent accidental data loss. Has no effect when writing to stdout ('-').

-q,  --quiet

Suppress diagnostic messages and progress indicators. Only error messages will be displayed.

-h,  --help

Print help (see a summary with '-h')

<INPUT>

The source recording to convert. Can be a local file path, HTTP(S) URL for remote files, or '-' to read from standard input. Remote URLs allow converting recordings directly from the web without need for manual downloading. Supported input formats include asciicast v1, v2 and v3

<OUTPUT>

The output path for the converted recording. Can be a file path or '-' to write to standard output

Examples:

 asciinema convert old.cast new.cast
     Converts a recording to the latest asciicast format (v3)

 asciinema convert demo.cast demo.txt
     Exports a recording as a plain-text log - output format inferred from the .txt extension

 asciinema convert --output-format raw demo.cast demo.txt
     Exports as raw terminal output

 asciinema convert -f txt demo.cast -
     Exports as plain text to stdout

 asciinema convert https://asciinema.org/a/569727 starwars.cast
     Downloads a remote recording and converts it to the latest asciicast format (v3)

asciinema(1).