asciinema-convert(1)

NAME
asciinema-convert - Convert a recording to another format

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

DESCRIPTION
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.

OPTIONS

-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

EXTRA
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)