一. 简介

asciinema.org是一个非常方便的命令行录制工具。当我们不像使用录屏工具时，使用asciinema可以实现文本方式的录屏。并且，占用体积很小，可以暂停和回放，且可以云端管理。

二. 原理

asciinema 项目由几个互补部分构成：

• 基于命令行的终端会话记录器asciinema
• 具有asciinema.org API的网站
• javascript播放器

将终端的操作记录成 JSON 格式，然后使用 JavaScript 解析，配合CSS展示，看起来像是视频播放器。实际上就是文本，相比GIF和视频文件体积非常之小，无需缓冲播放，也可以方便的分享给别人或嵌入到网页中。

三. 使用

3.1 安装asciinema

macOS指令如下：

brew install asciinema

Pip安装

sudo pip3 install asciinema

Arch Linux

pacman -S asciinema

Debian

sudo apt-get install asciinema

3.2 启动asciinema记录

要开始记录，请运行以下命令：

asciinema rec

这将产生一个新的shell实例并记录所有终端输出。当您准备完成时，只需键入exit或选择Ctrl-D.

3.3 管理asciinema记录（可选）

如果要在asciinema.org上管理录音（设置标题/描述，删除等），则需要进行身份验证。运行以下命令并在Web浏览器中打开显示的URL：

asciinema auth

3.4 本地或云端回放（可选）

云端回放：

asciinema play https://asciinema.org/a/400163

本地回放

asciinema play /path/400163.json

3.5 嵌入网站

登陆到asciinema网站，查看对应的record。一定要将该record设置为public，这样大家才能够都看到。同时，在share页面上有各种已经包含的嵌入格式，方便用户使用。

更多细节，可以查看这个链接Sharing & embedding。

share.png

3.6 展示

按照上面的命令行执行，录制了一record如下

https://asciinema.org/a/400163

四. 总结

这个asciinema工具，无论是对开发者还是创作者都有帮助。

• 对于我们这种经常写作，有时为了体现实操情况，我们就需要使用重量级的录屏工具，或者特地制作GIF图。这样的事情非常耗时耗力，并且跨平台性极差，甚至很多平台不方便第三方录屏。asciinema工具可以简化展示，实现极强的动态跨平台性。
• 对于开发者来说，该命令行不是纯展示的。当执行asciinema play指令时，该json中的命令行会真正的运行，所以一定程度上可以讲它理解为一个脚本，某些场景下的重复工作可以使用它来协作完成。
• 当然缺点是明显的，这个asciinema工具只针对命令行的记录，而且不支持windows。

但是对于我们来说，能解决问题的工具就是好工具，不对吗？