mirror of
https://github.com/LCTT/TranslateProject.git
synced 2024-12-26 21:30:55 +08:00
313 lines
12 KiB
Markdown
313 lines
12 KiB
Markdown
[#]: collector: (lujun9972)
|
||
[#]: translator: ( )
|
||
[#]: reviewer: ( )
|
||
[#]: publisher: ( )
|
||
[#]: url: ( )
|
||
[#]: subject: (Asciinema – Record And Share Your Terminal Sessions On The Fly)
|
||
[#]: via: (https://www.2daygeek.com/linux-asciinema-record-your-terminal-sessions-share-them-on-web/)
|
||
[#]: author: (Magesh Maruthamuthu https://www.2daygeek.com/author/magesh/)
|
||
|
||
Asciinema – Record And Share Your Terminal Sessions On The Fly
|
||
======
|
||
|
||
This is known topic and we had already written so many article about this topic.
|
||
|
||
Even today also we are going to discuss about the same topic.
|
||
|
||
Other tools are works locally but Asciinema works in both way like local and web.
|
||
|
||
I mean we can share the recording on the web.
|
||
|
||
By default everyone prefer history command to review/recall the previously entered commands in terminal.
|
||
|
||
But unfortunately, that shows only the commands that we ran and doesn’t shows the commands output which was performed previously.
|
||
|
||
There are many utilities available in Linux to record the terminal session activity.
|
||
|
||
Also, we had written about few utilities in the past and today also we are going to discuss about the same kind of topic.
|
||
|
||
If you would like to check other utilities to record your Linux terminal session activity then you can give a try to **[Script Command][1]** , **[Terminalizer Tool][2]** and **[Asciinema Tool][3]**.
|
||
|
||
But if you are looking for **[GIF Recorder][4]** then try **[Gifine][5]** , **[Kgif][6]** and **[Peek][7]** utilities.
|
||
|
||
### What is Asciinema
|
||
|
||
asciinema is a free and open source solution for recording terminal sessions and sharing them on the web.
|
||
|
||
When you run asciinema rec in your terminal the recording starts, capturing all output that is being printed to your terminal while you’re issuing the shell commands.
|
||
|
||
When the recording finishes (by hitting `Ctrl-D` or typing `exit`) then the captured output is uploaded to asciinema.org website and prepared for playback on the web.
|
||
|
||
Asciinema project is built of several complementary pieces such as asciinema command line tool, API at asciinema.org and javascript player.
|
||
|
||
Asciinema was inspired by script and scriptreplay commands.
|
||
|
||
### How to Install Asciinema In Linux
|
||
|
||
It was written in Python and pip installation is a recommended method to install Asciinema on Linux.
|
||
|
||
Make sure you should have installed python-pip package on your system. If no, use the following command to install it.
|
||
|
||
For Debian/Ubuntu users, use **[Apt Command][8]** or **[Apt-Get Command][9]** to install pip package.
|
||
|
||
```
|
||
$ sudo apt install python-pip
|
||
```
|
||
|
||
For Archlinux users, use **[Pacman Command][10]** to install pip package.
|
||
|
||
```
|
||
$ sudo pacman -S python-pip
|
||
```
|
||
|
||
For Fedora users, use **[DNF Command][11]** to install pip package.
|
||
|
||
```
|
||
$ sudo dnf install python-pip
|
||
```
|
||
|
||
For CentOS/RHEL users, use **[YUM Command][12]** to install pip package.
|
||
|
||
```
|
||
$ sudo yum install python-pip
|
||
```
|
||
|
||
For openSUSE users, use **[Zypper Command][13]** to install pip package.
|
||
|
||
```
|
||
$ sudo zypper install python-pip
|
||
```
|
||
|
||
Finally run the following **[pip command][14]** to install Asciinema tool in Linux.
|
||
|
||
```
|
||
$ sudo pip3 install asciinema
|
||
```
|
||
|
||
### How to Record Your Terminal Session Using Asciinema
|
||
|
||
Once you successfully installed Asciinema. Just run the following command to start recording.
|
||
|
||
```
|
||
$ asciinema rec 2g-test
|
||
asciinema: recording asciicast to 2g-test
|
||
asciinema: press "ctrl-d" or type "exit" when you're done
|
||
```
|
||
|
||
For testing purpose run few commands and see whether it’s working fine or not.
|
||
|
||
```
|
||
$ free
|
||
total used free shared buff/cache available
|
||
Mem: 15867 2783 10537 1264 2546 11510
|
||
Swap: 17454 0 17454
|
||
|
||
$ hostnamectl
|
||
Static hostname: daygeek-Y700
|
||
Icon name: computer-laptop
|
||
Chassis: laptop
|
||
Machine ID: 31bdeb7b833547368d230a2025d475bc
|
||
Boot ID: c84f7e6f39394d1f8fdc4bcaa251aee2
|
||
Operating System: Manjaro Linux
|
||
Kernel: Linux 4.19.8-2-MANJARO
|
||
Architecture: x86-64
|
||
|
||
$ uname -a
|
||
Linux daygeek-Y700 4.19.8-2-MANJARO #1 SMP PREEMPT Sat Dec 8 14:45:36 UTC 2018 x86_64 GNU/Linux
|
||
|
||
$ lscpu
|
||
Architecture: x86_64
|
||
CPU op-mode(s): 32-bit, 64-bit
|
||
Byte Order: Little Endian
|
||
Address sizes: 39 bits physical, 48 bits virtual
|
||
CPU(s): 8
|
||
On-line CPU(s) list: 0-7
|
||
Thread(s) per core: 2
|
||
Core(s) per socket: 4
|
||
Socket(s): 1
|
||
NUMA node(s): 1
|
||
Vendor ID: GenuineIntel
|
||
CPU family: 6
|
||
Model: 94
|
||
Model name: Intel(R) Core(TM) i7-6700HQ CPU @ 2.60GHz
|
||
Stepping: 3
|
||
CPU MHz: 800.047
|
||
CPU max MHz: 3500.0000
|
||
CPU min MHz: 800.0000
|
||
BogoMIPS: 5186.00
|
||
Virtualization: VT-x
|
||
L1d cache: 32K
|
||
L1i cache: 32K
|
||
L2 cache: 256K
|
||
L3 cache: 6144K
|
||
NUMA node0 CPU(s): 0-7
|
||
Flags: fpu vme de pse tsc msr pae mce cx8 apic sep mtrr pge mca cmov pat pse36 clflush dts acpi mmx fxsr sse sse2 ss ht tm pbe syscall nx pdpe1gb rdtscp lm constant_tsc art arch_perfmon pebs bts rep_good nopl xtopology nonstop_tsc cpuid aperfmperf tsc_known_freq pni pclmulqdq dtes64 monitor ds_cpl vmx est tm2 ssse3 sdbg fma cx16 xtpr pdcm pcid sse4_1 sse4_2 x2apic movbe popcnt tsc_deadline_timer aes xsave avx f16c rdrand lahf_lm abm 3dnowprefetch cpuid_fault epb invpcid_single pti ssbd ibrs ibpb stibp tpr_shadow vnmi flexpriority ept vpid ept_ad fsgsbase tsc_adjust bmi1 hle avx2 smep bmi2 erms invpcid rtm mpx rdseed adx smap clflushopt intel_pt xsaveopt xsavec xgetbv1 xsaves dtherm ida arat pln pts hwp hwp_notify hwp_act_window hwp_epp flush_l1d
|
||
```
|
||
|
||
Once you have done, simple press `CTRL+D` or type `exit` to stop the recording. The result will be saved in the same directory.
|
||
|
||
```
|
||
$ exit
|
||
exit
|
||
asciinema: recording finished
|
||
asciinema: asciicast saved to 2g-test
|
||
```
|
||
|
||
If you would like to save the output in the different directory then mention the path where you want to save the file.
|
||
|
||
```
|
||
$ asciinema rec /opt/session-record/2g-test1
|
||
```
|
||
|
||
We can play the recorded session using the following command.
|
||
|
||
```
|
||
$ asciinema play 2g-test
|
||
```
|
||
|
||
We can play the recorded session with double speed.
|
||
|
||
```
|
||
$ asciinema play -s 2 2g-test
|
||
```
|
||
|
||
Alternatively we can play the recorded session with normal speed with idle time limited to 2 seconds.
|
||
|
||
```
|
||
$ asciinema play -i 2 2g-test
|
||
```
|
||
|
||
### How To Share the Recorded Session on The Web
|
||
|
||
If you would like to share the recorded session with your friends, just run the following command which upload the recording to asciinema.org and provide you the unique link.
|
||
|
||
It will be automatically archived 7 days after upload.
|
||
|
||
```
|
||
$ asciinema upload 2g-test
|
||
View the recording at:
|
||
|
||
https://asciinema.org/a/jdJrxhDLboeyrhzZRHsve0x8i
|
||
|
||
This installation of asciinema recorder hasn't been linked to any asciinema.org
|
||
account. All unclaimed recordings (from unknown installations like this one)
|
||
are automatically archived 7 days after upload.
|
||
|
||
If you want to preserve all recordings made on this machine, connect this
|
||
installation with asciinema.org account by opening the following link:
|
||
|
||
https://asciinema.org/connect/10cd4f24-45b6-4f64-b737-ae0e5d12baf8
|
||
```
|
||
|
||
![][16]
|
||
|
||
If you would like to share the recorded session on social media, just click the `Share` button in the bottom of the page.
|
||
|
||
If anyone wants to download this recording, just click the `Download` button in the bottom of the page to save on your system.
|
||
|
||
### How to Manage Recording on asciinema.org Site
|
||
|
||
If you want to preserve all recordings made on this machine, connect this installation with asciinema.org account by opening the following link and follow the instructions.
|
||
|
||
```
|
||
https://asciinema.org/connect/10cd4f24-45b6-4f64-b737-ae0e5d12baf8
|
||
```
|
||
|
||
If you have already recorded an asciicast but you don’t see it on your profile on asciinema.org website. Just run the `asciinema auth` command in your terminal to move those.
|
||
|
||
```
|
||
$ asciinema auth
|
||
|
||
Open the following URL in a web browser to link your install ID with your asciinema.org user account:
|
||
|
||
https://asciinema.org/connect/10cd4f24-45b6-4f64-b737-ae0e5d12baf8
|
||
|
||
This will associate all recordings uploaded from this machine (past and future ones) to your account, and allow you to manage them (change title/theme, delete) at asciinema.org.
|
||
```
|
||
|
||
![][17]
|
||
|
||
Run the following command if you would like to upload the file directly to asciinema.org instead of locally saving.
|
||
|
||
```
|
||
$ asciinema rec
|
||
asciinema: recording asciicast to /tmp/tmp6kuh4247-ascii.cast
|
||
asciinema: press "ctrl-d" or type "exit" when you're done
|
||
```
|
||
|
||
Just run the following command to start recording.
|
||
|
||
```
|
||
$ asciinema rec 2g-test
|
||
asciinema: recording asciicast to 2g-test
|
||
asciinema: press "ctrl-d" or type "exit" when you're done
|
||
```
|
||
|
||
For testing purpose run few commands and see whether it’s working fine or not.
|
||
|
||
```
|
||
$ free
|
||
total used free shared buff/cache available
|
||
Mem: 15867 2783 10537 1264 2546 11510
|
||
Swap: 17454 0 17454
|
||
|
||
$ hostnamectl
|
||
Static hostname: daygeek-Y700
|
||
Icon name: computer-laptop
|
||
Chassis: laptop
|
||
Machine ID: 31bdeb7b833547368d230a2025d475bc
|
||
Boot ID: c84f7e6f39394d1f8fdc4bcaa251aee2
|
||
Operating System: Manjaro Linux
|
||
Kernel: Linux 4.19.8-2-MANJARO
|
||
Architecture: x86-64
|
||
|
||
$ uname -a
|
||
Linux daygeek-Y700 4.19.8-2-MANJARO #1 SMP PREEMPT Sat Dec 8 14:45:36 UTC 2018 x86_64 GNU/Linux
|
||
```
|
||
|
||
Once you have done, simple press `CTRL+D` or type `exit` to stop the recording then hit `Enter` button to upload the recording to asciinema.org website.
|
||
|
||
It will take few seconds to generate the unique url for your uploaded recording. Once it’s done you will be getting the results same as below.
|
||
|
||
```
|
||
$ exit
|
||
exit
|
||
asciinema: recording finished
|
||
asciinema: press "enter" to upload to asciinema.org, "ctrl-c" to save locally
|
||
|
||
View the recording at:
|
||
|
||
https://asciinema.org/a/b7bu5OhuCy2vUH7M8RRPjsSxg
|
||
```
|
||
|
||
--------------------------------------------------------------------------------
|
||
|
||
via: https://www.2daygeek.com/linux-asciinema-record-your-terminal-sessions-share-them-on-web/
|
||
|
||
作者：[Magesh Maruthamuthu][a]
|
||
选题：[lujun9972][b]
|
||
译者：[译者ID](https://github.com/译者ID)
|
||
校对：[校对者ID](https://github.com/校对者ID)
|
||
|
||
本文由 [LCTT](https://github.com/LCTT/TranslateProject) 原创编译，[Linux中国](https://linux.cn/) 荣誉推出
|
||
|
||
[a]: https://www.2daygeek.com/author/magesh/
|
||
[b]: https://github.com/lujun9972
|
||
[1]: https://www.2daygeek.com/script-command-record-save-your-terminal-session-activity-linux/
|
||
[2]: https://www.2daygeek.com/terminalizer-a-tool-to-record-your-terminal-and-generate-animated-gif-images/
|
||
[3]: https://www.2daygeek.com/Asciinema-record-your-terminal-sessions-as-svg-animations-in-linux/
|
||
[4]: https://www.2daygeek.com/category/gif-recorder/
|
||
[5]: https://www.2daygeek.com/gifine-create-animated-gif-vedio-recorder-linux-mint-debian-ubuntu/
|
||
[6]: https://www.2daygeek.com/kgif-create-animated-gif-file-active-window-screen-recorder-capture-arch-linux-mint-fedora-ubuntu-debian-opensuse-centos/
|
||
[7]: https://www.2daygeek.com/peek-create-animated-gif-screen-recorder-capture-arch-linux-mint-fedora-ubuntu/
|
||
[8]: https://www.2daygeek.com/apt-command-examples-manage-packages-debian-ubuntu-systems/
|
||
[9]: https://www.2daygeek.com/apt-get-apt-cache-command-examples-manage-packages-debian-ubuntu-systems/
|
||
[10]: https://www.2daygeek.com/pacman-command-examples-manage-packages-arch-linux-system/
|
||
[11]: https://www.2daygeek.com/dnf-command-examples-manage-packages-fedora-system/
|
||
[12]: https://www.2daygeek.com/yum-command-examples-manage-packages-rhel-centos-systems/
|
||
[13]: https://www.2daygeek.com/zypper-command-examples-manage-packages-opensuse-system/
|
||
[14]: https://www.2daygeek.com/install-pip-manage-python-packages-linux/
|
||
[15]: data:image/gif;base64,R0lGODlhAQABAIAAAAAAAP///yH5BAEAAAAALAAAAAABAAEAAAIBRAA7
|
||
[16]: https://www.2daygeek.com/wp-content/uploads/2018/12/linux-asciinema-record-your-terminal-sessions-share-web-1.png
|
||
[17]: https://www.2daygeek.com/wp-content/uploads/2018/12/linux-asciinema-record-your-terminal-sessions-share-web-3.png
|