asciinema-convert(1)        General Commands Manual       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:

                     o asciicast-v3: Full-featured session format, with timing
                       and metadata (current generation) -
                       https://docs.asciinema.org/manual/asciicast/v3/

                     o asciicast-v2: Full-featured session format, with timing
                       and metadata (previous generation) -
                       https://docs.asciinema.org/manual/asciicast/v2/

                     o raw: Raw terminal output, including control sequences,
                       without timing and metadata

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

                                   convert                asciinema-convert(1)