asciinema/asciinema

这是什么？

核心功能

• 01将终端会话录制为轻量的 .cast 文件，可选捕获键盘输入。
• 02回放时支持调整速度、循环、限制空闲时间，并可在标记处暂停。
• 03通过内置 HTTP 服务器或中继服务器向多个观众实时直播。
• 04支持 zstd 压缩录像，并可在 asciicast 版本与纯文本之间转换。
• 05支持拼接多个录像，提供快捷键绑定、配置文件和无头模式，便于脚本和 CI 使用。

适用场景

• 将命令行操作或问题复现录成可分享、可复制文本的录像。
• 通过网页播放器把终端演示嵌入项目文档或博客。
• 让团队成员或学生在浏览器中实时观看终端会话。
• 录制脚本或 CI 运行过程，并保留退出状态。

快速上手

1. 1

   使用 Cargo 安装 CLI（需要 Rust 1.82 或更高版本）

   cargo install --locked --git https://github.com/asciinema/asciinema
2. 2

   确保 $HOME/.cargo/bin 已加入 shell 的 PATH

3. 3

   将终端会话录制到文件

   asciinema rec demo.cast

使用前须知

• !不支持 Windows，仅运行于 GNU/Linux、macOS 和 FreeBSD。
• !采用 GPL-3.0 许可证，这是一种 copyleft 许可证，衍生作品须保持开源。
• !从源码构建需要 Rust 工具链，版本 1.82 或更高。

收录于专题

标签

常见问题

asciinema 是什么？

命令行工具，可录制、实时直播和回放终端会话，输出轻量的 asciicast 文件而非视频。 asciinema 是一个用于录制和实时直播终端会话的命令行工具。它在终端内运行，把文本输出保存为 asciicast（.cast）文件。这种文件体积远小于屏幕录像，可以在终端中回放，也能通过 asciinema player 嵌入网页，或上传到 asciinema.org 等服务器分享。

asciinema 可以免费使用吗？用的什么许可证？

asciinema 以 GPL-3.0 许可证开源。用于商业产品前，请先确认许可证条款。

asciinema 还在维护吗？

活跃维护中。asciinema 最近一次提交是在 2026年11月5日。

asciinema 适合用来做什么？

将命令行操作或问题复现录成可分享、可复制文本的录像。 通过网页播放器把终端演示嵌入项目文档或博客。 让团队成员或学生在浏览器中实时观看终端会话。 录制脚本或 CI 运行过程，并保留退出状态。

asciinema 怎么安装和运行？

使用 Cargo 安装 CLI（需要 Rust 1.82 或更高版本）: cargo install --locked --git https://github.com/asciinema/asciinema 确保 $HOME/.cargo/bin 已加入 shell 的 PATH 将终端会话录制到文件: asciinema rec demo.cast

在哪里获取 asciinema？

源代码和安装说明在 GitHub 上：https://github.com/asciinema/asciinema