asciinema讓您輕松記錄終端會話,並在終端和網頁瀏覽器中重播它們。
安裝最新版本:
sapt-get install asciinema
記錄你的第一個終端視頻:
asciinema rec first.cast
現在以倍速重播:
asciinema play -s 2 first.cast
或者正常速度,但空閑時間限制為2秒:
asciinema play -i 2 first.cast
您可以通過-i 2
在asciinema rec時
,永久設置它的記錄。空閑時間限制使得觀看記錄更有趣,嘗試一下。
如果你想在網上觀看和分享,請上傳它:
asciinema upload first.cast
上面的代碼將它上傳到asciinema.org,這是一個默認的asciinema-server 實例,並打印一個秘密鏈接,您可以使用它來在Web瀏覽器中觀看您的錄制內容。
您可以通過省略文件名一步記錄和上傳:
asciinema rec
錄制完成后,系統會要求您確認上傳,因此未經您的同意,任何地方都不會發送任何內容。
這些都是基礎知識,但還有更多可以做的事情。以下部分將更詳細地介紹錄制的安裝,使用和托管。
用法:
rec [name]
記錄終端回話命令。
通過運行asciinema rec [filename]
你開始一個新的記錄會話。
錄制完成時,您退出殼(命中Ctrl+D或鍵入 exit
)。
如果filename
參數被忽略,那么(請求確認后)將生成的asciicast上傳到 asciinema-server(默認為asciinema.org),在那里可以觀看和共享。
如果filename
給出了參數,那么生成的記錄(稱為 asciicast)將保存到本地文件中。它可以稍后重播asciinema play <filename>
和/或上傳到asciinema服務器asciinema upload <filename>
。
ASCIINEMA_REC=1
被添加到記錄的過程環境變量。這可以被shell的配置文件(.bashrc
,.zshrc
)用來改變提示或者在shell被錄制時播放聲音。
可用選項:
--stdin
- 啟用標准輸入(鍵盤)錄制(請參閱下文)--append
- 追加到現有的錄音--raw
- 保存原始STDOUT輸出,無需定時信息或其他元數據--overwrite
- 覆蓋已存在的記錄-c, --command=<command>
- 指定要記錄的命令,默認為$ SHELL-e, --env=<var-names>
- 要捕獲的環境變量列表,默認為SHELL,TERM
-t, --title=<title>
- 指定asciicast的標題-i, --idle-time-limit=<sec>
- 將記錄的終端非活動<sec>
時間限制為最大秒數-y, --yes
- 對所有提示回答“是”(例如上傳確認)-q, --quiet
- 保持安靜,壓制所有通知/警告(暗示-y)
Stdin錄制允許捕獲用戶在當前錄制的外殼中鍵入的所有字符。這可以被玩家(例如 asciinema-player)用來顯示按下的按鍵。因為它基本上是一個鍵盤日志記錄(作用於單個shell實例),所以默認情況下它是禁用的,並且必須通過--stdin
選項明確啟用 。
play <filename>
重放錄制在終端asciicast。
該命令rec
直接在終端中重播給定的asciicast(由命令記錄)。
以下鍵盤快捷鍵可用:
- Space - 切換暫停,
- . - 逐步完成一幀錄制(暫停時),
- Ctrl+C - 出口。
從本地文件播放:
asciinema play /path/to/asciicast.cast
從HTTP(S)URL播放:
asciinema play https://asciinema.org/a/22124.cast asciinema play http://example.com/demo.cast
可用選項:
-i, --idle-time-limit=<sec>- 將重播終端的不活動限制在最大<sec>秒數
-s, --speed=<factor> - 播放速度(可以是小數)
為了獲得最佳的播放體驗,建議asciinema play
在尺寸不小於用於記錄的終端中運行,因為對於新的終端尺寸,控制序列沒有“轉碼”。
cat <filename>
將記錄的全部shell命令輸出打印到終端。
在asciinema play <filename>
使用保存在asciicast中的時間信息重播記錄的會話時,立即asciinema cat <filename>
將全部輸出(包括所有轉義序列)轉儲到終端。
asciinema cat existing.cast >output.txt
把記錄的shell命令輸出到output.txt文件中
upload <filename>
上傳記錄的asciicast到asciinema.org網站。
該命令將asciicast(通過rec
命令記錄)上傳到asciinema.org,在那里可以觀看和共享。
asciinema rec demo.cast
如果您想在asciinema.org發布之前查看一個asciicast,那么+ asciinema play demo.cast
+ asciinema upload demo.cast
是一個很好的組合。