asciinema-convert(1)

okay bestie, welcome to asciinema-convert(1) — the General Commands Manual page for the asciinema convert command. It's giving terminal-glowup energy, and I'm obsessed 💅✨

🌸 NAME 🌸

asciinema-convert — Convert a recording to another format 💖

🎀 SYNOPSIS 🎀

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

💖 DESCRIPTION 💖

This icon converts a recording to another format. It transforms asciicast files between different formats (v1, v2, v3) or exports to other formats like raw terminal output or plain text. It supports reading from files, URLs, or stdin and writing to files or stdout. Literally all the flexible vibes, no cap 🦋

✨ 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 ('-'). Protect your faves, bestie! 🫶
• -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, queen: 👑

• 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) ⭐

---

cute sign-off: this footer energy is convert + asciinema-convert(1) — and there's no date printed, so I'm not inventing one. byeee, go convert something iconic 💅🫶💖