README
¶
What is asciinema?
asciinema [as-kee-nuh-muh] is a free and open source solution for recording terminal sessions and sharing them on the web. To learn about asciinema, you can visit asciinema.org.
And this project is a cross-platform version of asciinema writtern in go with full features. You can use it to create, edit, upload, convert(to gif animation) an asciinema cast on MacOS/Linux/Windows.
Installation
- Recommanded: Install acast using version manager vm.
vm use asciinema@v0.3.9
- Install acast using go.
go install github.com/gvcgo/asciinema/cmd/acast@latest
- Download acast from releases. releases
Subcommands
| subcommand | args example | desc |
|---|---|---|
| auth | - | Authorizes to your asciinema.org account. |
| convert-to-gif | input.cast output.gif | Converts a cast to gif animation. |
| cut | --start=0.0 --end=2.9 input.cast output.cast | Removes a certain range of a cast. |
| play | input.cast | Plays a cast. |
| quantize | --ranges=1.0,5.0 input.cast output.cast | Updates the cast delays following quantization ranges. |
| record | xxx.cast | Starts recording a cast. |
| speed | --start=0.0 --end=2.9 --factor=0.7 input.cast output.cast | Updates the speed of a cast by certain factor. |
| upload | xxx.cast | Uploads a cast to asciinema.org. |
| version | - | Shows version info of acast. |
Demo
-
Normal Speed
-
Normal Speed Converted to GIF
-
Speed x2
-
Speed x2 Converted to GIF
Thanks To
- go-asciinema provided most of the code for unix-like platforms.
- PowerSession-rs inspired me the conpty fixes.
- conpty-go
- conpty
- asciinema-edit
- agg
Directories
Click to show internal directories.
Click to hide internal directories.