Terminali sessioonide salvestus ja jagamine: Difference between revisions

From ICO wiki
Jump to navigationJump to search
 
(68 intermediate revisions by 3 users not shown)
Line 1: Line 1:
==Sissejuhatus==
==Sissejuhatus==
Terminalis toimunu salvestamiseks ning jagamiseks on mitmeid võimalusi. '''''Loetle siin mõndasid erinevaid'''''
Terminalis toimunu salvestamiseks ning jagamiseks on mitmeid võimalusi.


Sooviksin antud artiklis esile tuua asciinema projekti arendust, mis sai alguse ja inspiratsiooni "script" ja "scriptreplay" käskudest.
Käesolevas artiklis tutvustatakse asciinema projekti arendust, mis sai alguse ja inspiratsiooni "script" ja "scriptreplay" käskudest. [https://asciinema.org/ Asciinema] saadaval: Linux, macOS, *BSD. [https://github.com/ibigbug/PowerSession Analoog olemas ka MS Windowsile].


Asciinema rakendus võimaldab terminalis toimunu salvestada ning jagada asciinema.org lehe vahendusel, ehk jagades linki.
Asciinema rakendus võimaldab terminalis toimunu salvestada ning jagada asciinema.org lehe vahendusel, ehk jagades linki. Lisaks on võimalik rakendust ka oma serverisse paigaldada ja selle kaudu salvestusi suuremale hulgale huvilistele näidata.
 
Samuti võimalik lihtsalt salvestus (olemuselt tegelikult tekstifail) mistahes failiserverisse üles panna ja otseligipääsu korral ka otse arvuti käsurealt vaadata, seejuures esituskiirust paindlikult muutes. Sellisel juhul asciinema serverit vaja ei ole, kui salvestust otse käsureal esitada (üle võrgu, kohalikust masinast).


==Paigaldamine==
==Paigaldamine==
Line 10: Line 12:
Asciinema on võimalik paigaldada erineval viisil, täpsemalt leiab informatsiooni võimalustest asciinema lehelt programmi paigalduse rubriigist.
Asciinema on võimalik paigaldada erineval viisil, täpsemalt leiab informatsiooni võimalustest asciinema lehelt programmi paigalduse rubriigist.


Antud artiklis toon esile Linux Ubuntu paigalduse käsuread.
Ubuntu
 
Ubuntu Linux 18.10 ja vanemates versioonides [https://launchpad.net/~zanchey/+archive/ubuntu/asciinema vajalik eraldi varamu] kuid tegelikult juba [https://packages.ubuntu.com/search?keywords=asciinema&searchon=names&suite=all&section=all alates Ubuntu 16.04 LTS'ist on asciinema Universe'i varamus olemas].
 
[https://asciinema.org/a/403863 Siin ka väike video] asciinema tarkvarapaketi otsimisest, paigaldamisest, juhiste vaatamisest.


   sudo apt-add-repository ppa:zanchey/asciinema
   apt search asciinema
   sudo apt-get update
   apt show asciinema
   sudo apt-get install asciinema
   sudo apt install asciinema
  asciinema -h
  man asciinema


Teiste opsüsteemide tarvis on paigaldusjuhised siin:
Teiste operatsioonisüsteemide tarvis on paigaldusjuhised siin:
https://asciinema.org/docs/installation
https://asciinema.org/docs/installation
MS Windowsile (PowerShell) on sisuliselt sama asi olemas - https://github.com/ibigbug/PowerSession
==Failivorming==
Kuigi räägime "videost", siis tegelikult terminalisalvestuse puhul sisuliselt tegemist väikesemahulise tekstifailiga toores režiimis (''less -r'' näitab ka), mida asciinema animeerib.:
* asciinema v1.x - [https://github.com/asciinema/asciinema/blob/master/doc/asciicast-v1.md JSON]
* asciinema v2.x - [https://github.com/asciinema/asciinema/blob/develop/doc/asciicast-v2.md asciicast]
Lisalugemist leiab [https://blog.asciinema.org/post/two-point-o/ Asciinema v2.0 artiklist].


==Kasutamine==
==Kasutamine==


Ekraanil toimuva salvestamiseks kasuta käsku:
[https://asciinema.org/docs/usage Juhised leiab asciinema kodulehelt.]
 
Ekraanil toimuva salvestamiseks kasutada käsku:
 
  asciinema rec [/teekond/kataloogi/failinimi.cast] [-t "Pealkiri salvestusele"]


  asciinema rec [failinimi]
Kui kohalikku failinime ei anta, laaditakse pärast salvestamise lõppu salvestus automaatselt vaikimisi serverisse üles. Vastasel korral tehakse kohalik salvestus ja midagi kohe üles ei laadita. Nurksulud annavadki sellest märku, et failinimi ei ole kohustuslik, kuid samas on toetatud. Sama on pealkirja määramisega. Kui pealkirjas erisümboleid (tühikud, täpitähed) ei ole, siis pole jutumärke ka vaja või siis saab erisümboleid kohelda vastavalt kasutatavale kestprogrammile. Pealkirja saab hiljem veebis ka muuta, kui arvuti on profiiliga veebis ära seotud.


Salvestuse lõpetamiseks vajuta CTRL-D või kasuta käsku:
Salvestuse lõpetamiseks vajuta CTRL-D või kasuta käsku:
Line 29: Line 52:
   exit
   exit


Salvestatud sessioonide taasesitluseks on käsud.
Salvestamise käivitamisel määratakse salvestuse asukoht arvutis läbi faili otsiteekonna (''path'') määramise.


Arvutis paiknevast failist:
Salvestatud sessioonide taasesitluseks


  asciinema play  /teekond/kataloogi/failinimi.json
- arvutis paiknevast failist:


Taasesitlus internetist:
  asciinema play /teekond/kataloogi/failinimi.cast


   asciinema play https//asciinema.org/a/failinimi.json
   less -r /teekond/kataloogi/failinimi.cast #ka võimalus sisu vaadata
  asciinema play http//omaleht.ee/failinimi.json


Video üles laadimiseks käsk:
- internetist:


   asciinema upload failinimi.json
   asciinema play https://asciinema.org/a/faili-id


Küsitakse kas laadida üles video - vali y (yes)
Kahekordse kiirusega (-s speed) vaatamine, enda masinasse üles pandud:
  asciinema play https://enos.itcollege.ee/~edmund/materials/terminal-recording-streaming/asciinema.cast -s 2


Juhul kui Teil on plaanis ekraanil toimunu salvestada ning hiljem soov üleslaadida, siis saab kasutada käskude jada, mis alustab salvestamist võimaldab vaadta vdeot peale salvestuse lõppu ning laeb faili üles.
'''Olemuslikult tegemist tegelikult väikesemahulise tekstifailiga, mida asciinema suudab videona näidata. Seejuures on tekst video seest kopeeritav.'''


  asciinema rec demo.json + asciinema play demo.json + asciinema upload demo.json
Kusjuures toetatud on ka kümnendmurrud kiiruse määramisel, nt -s 1.2 (koma asemel tuleb punkti kasutada).


Oma salvestuste kustutamiseks või muutmiseks peab ennast identifitseerima käsuga
Sama video üleval ka ametlikul lehel, samuti saab ise vaatamiskiirust määrata:
  asciinema play https://asciinema.org/a/403863 -s 2


  auth
Video üleslaadimiseks:


Antud käsk kuvab veebi aadressi mille kaudu saab muuta enda salvestsatud faile.
  asciinema upload failinimi.cast


Kasutades aciinema teises arvutis omistatakse omistatakse sulle unikaalne tunnus ing kui oled Accinema.org lehel sisseloginud , siis antud käsuga on võimalik siduda arvuti sinu asciinema kontoga:
Kui oma serverisse, siis vt [[#S.C3.A4tted|allpool võimalus ka see seadistada]]
 
Juhul, kui Teil on plaanis ekraanil toimunu salvestada ning hiljem soov üles laadida, siis saab kasutada käskude jada, mis alustab salvestamist, võimaldab vaadata videot peale salvestuse lõppu ning laeb faili üles:
 
  asciinema rec demo.cast + asciinema play demo.cast + asciinema upload demo.cast
 
Videote vistutamiseks veebis leiab [https://asciinema.org/docs/embedding juhised siit] (HTML, Markdown).
 
Oma salvestuste kustutamiseks või muutmiseks peab ennast tuvastama käsuga
 
  asciinema auth
 
==Seadistamine==
 
Arvuti võimalik siduda asciinema kontoga:


   asciinema auth
   asciinema auth
Antud käsk kuvab veebiaadressi kujul https://asciinema.org/connect/install-id, mille kaudu saab muuta enda salvestatud faile. Lisaks võimalik seadistada kasutaja koos kasutajanime, e-postiga mille aktiveerimiseks saadetakse e-postiga link. asciinema paigalduse ID asub failis '''$HOME/.config/asciinema/install-id''' ja seda ID'd kasutataksegi arvuti sidumisel veebikontoga.
Kasutades asciinemat teises arvutis, saab sama ID'd kasutada, kui soovitakse salvestuses sama kasutaja alla üles laadida.
Kui sama ID'd kasutada, ka siis tuleks see käsk ('''asciinema auth''') vähemalt üks kord käivitada. Siis lihtsalt avatakse juba olemasolev konto ehk siis sisuliselt sama ID'ga ([https://en.wikipedia.org/wiki/Access_token access token]) saab ligi.


Valikulised argumendid:
Valikulised argumendid:


   -c käivitab määratud käsu asemel shelli
   -c käivitab määratud käsu asemel kestprogrammi (shell)


   -t täpsustab salvestatud faili pealkirja
   -t täpsustab salvestatud faili pealkirja
Line 71: Line 116:


   -v versiooniteave
   -v versiooniteave
  man asciinema (põhjalikum juhend)


Asciinema videosid ei pea ilmtingimata laadima asciinema.org lehele. On võimalik ka seadistada oma leht antud otstarbeks.
Asciinema videosid ei pea ilmtingimata laadima asciinema.org lehele. On võimalik ka seadistada oma leht antud otstarbeks.
Line 77: Line 124:
https://github.com/asciinema/asciinema-server
https://github.com/asciinema/asciinema-server


Lisa oma ~/.config/asciinema/config konfiguratsioonifaili viide oma lehele:
Lisa oma ~/.config/asciinema/config sätetefaili viide oma lehele:


   [api]
   [api]
   url = http://asciinema.example.com
   url = http://asciinema.example.com
==Salvestuste teisendamine pildifailiks==
===GIF===
Alternatiivina, kui pole võimalust seadistada asciinema serverit ega kasutada avalikku serverit, siis on võimalik salvestusest luua GIF-fail.
https://github.com/asciinema/asciicast2gif - see paistab siiski aegunud olema uue asciinema 2.x jaoks, mis uut failivormingut kasutab.


==Konfiguratsioonifail==
[https://ezgif.com/help/alternative-animated-image-formats Lisateave ka animeeritud GIFi analoogide kohta.] Eriti paljutõotav on [https://flif.info/ Free Lossless Image Format (FLIF)]
Asciinema hoiab konfiguratsioonifailis API tunnust ja kasutaja seadeid. Üldjuhul faili asukoht on:  
===SVG===
Siin on olemas
* [https://github.com/marionebl/svg-term svg-term]
* [https://github.com/marionebl/svg-term-cli svg-term-cli]
* [https://github.com/sharkdp/fd/blob/master/doc/screencast.sh skript teksti automaatsisestuseks]
 
==Sätted==
Asciinema hoiab ligipääsu ID'd (sisuliselt [https://en.wikipedia.org/wiki/Universally_unique_identifier UUID]) eraldi failis
  $HOME/.config/asciinema/install-id
 
Esmase asciinema käivituse puhul luuakse ligipääsu ID ([https://en.wikipedia.org/wiki/Access_token access token]) ning salvestatakse antud faili, juhul kui seda pole tehtud samas arvutis varem või varasemalt loodud ID sinna ise salvestatud. Kui ise varasemalt loodud ID sinna pandud, siis kasutatakse seda kuid käivitada on igal juhul vähemalt üks kord vaja arvuti sidumiseks olemasoleva kasutajaprofiiliga asciinema.org veebis.
 
Üldjuhul eraldi sätetefaili asukoht on:  


   $HOME/.config/asciinema/config
   $HOME/.config/asciinema/config


Automaatselt genereeritud fail näeb välja selliselt
Seda asukohta saab muuta keskkonnamuutuja $ASCIINEMA_CONFIG_HOME abil.
 
Kui $XDG_CONFIG_HOME on määratud, siis asciinema kasutab $XDG_CONFIG_HOME/asciinema ja mitte $HOME/.config/asciinema


  [api]
Ennem stdin lubamist tasub lugeda [https://discourse.asciinema.org/t/does-asciinema-record-the-passwords-i-type-during-recording-session/23 seda postitust].
  token = <your-api-token-here>
 
Automaatselt loodud fail näeb välja selliselt


Konfiguratsiooni failis on võimalik seadistada mitme erineva täiendava parameetriga, kõik võimalikud parametrid:
  ; API server URL, default: https://asciinema.org
  ; If you run your own instance of asciinema-server then set its address here
  ; It can also be overriden by setting ASCIINEMA_API_URL environment variable
  ;url = https://asciinema.example.com


  [api]
Sätetefailis on võimalik seadistada täiendavalt:
  token = <your-api-token-here>
  url = https://asciinema.example.com


   [record]
   [record]
  ; Command to record, default: $SHELL
   command = /bin/bash -l
   command = /bin/bash -l
   maxwait = 2
 
   ; Enable stdin (keyboard) recording, default: no
  ;stdin = yes
 
  ; List of environment variables to capture, default: SHELL,TERM
  env = SHELL,TERM,USER
 
  ; Limit recorded terminal inactivity to max n seconds, default: off
  idle_time_limit = 3
 
  ; Answer "yes" to all interactive prompts, default: no
   yes = true
   yes = true
  ; Be quiet, suppress all notices/warnings, default: no
   quiet = true
   quiet = true


   [play]
   [play]
  maxwait = 1


Täiendava informatiooni leiab lingilt:
  ; Playback speed (can be fractional), default: 1
  speed = 2
 
  ; Limit replayed terminal inactivity to max n seconds, default: off
  ;idle_time_limit = 1
 
Täiendavat teavet seadistamise kohta leiab aadressilt:
https://asciinema.org/docs/config
https://asciinema.org/docs/config


==Autor==
==Teksti automaatsisestus==
Antud viited toimivad Linuxis. MS Windowsile tuleb veel lahendused leida.
* [https://stackoverflow.com/questions/53969566/how-can-i-use-scripting-automation-to-record-asciinema-recordings üldine arutelu]
* [https://github.com/paxtonhare/demo-magic konkreetne lahendus]
 
==Kokkuvõtte ja teised võimalused==
Tegemist on kasuliku lahendusega ekraanil toimuva salvestamiseks ning jagamiseks ning ei salvesta sisestatavaid paroole sessiooni ajal. Tööriist on kasulik kui soovitakse teha kas õppevideosi, koostada juhendeid või jagada informatsiooni.
Aciinema ei ole ainuvõimalus on ka teisi rakendusi sarnase funktsionaalsusega.
 
Näiteks:
 
  "ttyrec" - https://www.howtoforge.com/tutorial/how-to-record-your-terminal-session-on-linux/
 
  "bsdutils" - https://www.linuxnix.com/record-terminalshell-session-linux/
 
  "shelr" - https://www.techrepublic.com/blog/linux-and-open-source/record-and-share-your-terminal-session-with-shelrtv/
 
  "TermRecord" - http://xmodulo.com/record-replay-terminal-session-linux.html
 
jne..
 
==Autorid==
Edmund Laugasson, märts 2021, artikli kaasajastamine
 
Aleksandra Sepp, AK21, november 2017, artikli täiendamine, versioon 2.0  
Aleksandra Sepp, AK21, november 2017, artikli täiendamine, versioon 2.0  


Line 116: Line 225:


==Viited==
==Viited==
https://asciinema.org
https://asciinema.org ja näited salvestustest https://asciinema.org/explore


https://github.com/asciinema/asciinema
https://blog.asciinema.org/post/two-point-o/ - Asciinema v2.0
 
https://discourse.asciinema.org/ - arutelu
 
https://github.com/asciinema/asciinema - klientprogramm salvestamiseks
 
https://github.com/asciinema/asciinema-player - veebipõhine videote esitamine
 
https://github.com/asciinema/asciinema-server - serveri pool oma serverisse paigaldamiseks
 
https://github.com/ibigbug/PowerSession - asciinema PowerShellile MS Windowsis
 
https://asciinema.org/~lvm - näited PowerShellis salvestamisest
 
https://discourse.asciinema.org/t/does-asciinema-record-the-passwords-i-type-during-recording-session/23 - kohe ei tasu standardsisendit (stdin) ehk klaviatuuri salvestamist lubada, salasõnad võivad lekkida


https://anavarre.net/working-with-the-cli-you-should-probably-start-using-asciinema/
https://anavarre.net/working-with-the-cli-you-should-probably-start-using-asciinema/
Line 124: Line 247:
https://linuxconfig.org/record-and-replay-terminal-session-with-asciinema-on-linux
https://linuxconfig.org/record-and-replay-terminal-session-with-asciinema-on-linux


https://alternativeto.net/software/asciinema/ - alternatiivid (väga head alternatiivi ei ole)
https://ezgif.com/help/alternative-animated-image-formats - alternatiivsed animeeritud pildifailide vormingud, eriti paljutõotav on [https://flif.info/ Free Lossless Image Format (FLIF)]


https://asciinema.org/a/153907 - Star Wars, Episode IV. New Hope


[[Category:Operatsioonisüsteemide administreerimine ja sidumine]]
[[Category:Operatsioonisüsteemide administreerimine ja sidumine]]

Latest revision as of 22:51, 7 April 2021

Sissejuhatus

Terminalis toimunu salvestamiseks ning jagamiseks on mitmeid võimalusi.

Käesolevas artiklis tutvustatakse asciinema projekti arendust, mis sai alguse ja inspiratsiooni "script" ja "scriptreplay" käskudest. Asciinema saadaval: Linux, macOS, *BSD. Analoog olemas ka MS Windowsile.

Asciinema rakendus võimaldab terminalis toimunu salvestada ning jagada asciinema.org lehe vahendusel, ehk jagades linki. Lisaks on võimalik rakendust ka oma serverisse paigaldada ja selle kaudu salvestusi suuremale hulgale huvilistele näidata.

Samuti võimalik lihtsalt salvestus (olemuselt tegelikult tekstifail) mistahes failiserverisse üles panna ja otseligipääsu korral ka otse arvuti käsurealt vaadata, seejuures esituskiirust paindlikult muutes. Sellisel juhul asciinema serverit vaja ei ole, kui salvestust otse käsureal esitada (üle võrgu, kohalikust masinast).

Paigaldamine

Asciinema on võimalik paigaldada erineval viisil, täpsemalt leiab informatsiooni võimalustest asciinema lehelt programmi paigalduse rubriigist.

Ubuntu

Ubuntu Linux 18.10 ja vanemates versioonides vajalik eraldi varamu kuid tegelikult juba alates Ubuntu 16.04 LTS'ist on asciinema Universe'i varamus olemas.

Siin ka väike video asciinema tarkvarapaketi otsimisest, paigaldamisest, juhiste vaatamisest.

 apt search asciinema
 apt show asciinema
 sudo apt install asciinema
 asciinema -h
 man asciinema

Teiste operatsioonisüsteemide tarvis on paigaldusjuhised siin: https://asciinema.org/docs/installation

MS Windowsile (PowerShell) on sisuliselt sama asi olemas - https://github.com/ibigbug/PowerSession

Failivorming

Kuigi räägime "videost", siis tegelikult terminalisalvestuse puhul sisuliselt tegemist väikesemahulise tekstifailiga toores režiimis (less -r näitab ka), mida asciinema animeerib.:

Lisalugemist leiab Asciinema v2.0 artiklist.

Kasutamine

Juhised leiab asciinema kodulehelt.

Ekraanil toimuva salvestamiseks kasutada käsku:

 asciinema rec [/teekond/kataloogi/failinimi.cast] [-t "Pealkiri salvestusele"]

Kui kohalikku failinime ei anta, laaditakse pärast salvestamise lõppu salvestus automaatselt vaikimisi serverisse üles. Vastasel korral tehakse kohalik salvestus ja midagi kohe üles ei laadita. Nurksulud annavadki sellest märku, et failinimi ei ole kohustuslik, kuid samas on toetatud. Sama on pealkirja määramisega. Kui pealkirjas erisümboleid (tühikud, täpitähed) ei ole, siis pole jutumärke ka vaja või siis saab erisümboleid kohelda vastavalt kasutatavale kestprogrammile. Pealkirja saab hiljem veebis ka muuta, kui arvuti on profiiliga veebis ära seotud.

Salvestuse lõpetamiseks vajuta CTRL-D või kasuta käsku:

 exit

Salvestamise käivitamisel määratakse salvestuse asukoht arvutis läbi faili otsiteekonna (path) määramise.

Salvestatud sessioonide taasesitluseks

- arvutis paiknevast failist:

 asciinema play /teekond/kataloogi/failinimi.cast
 less -r /teekond/kataloogi/failinimi.cast #ka võimalus sisu vaadata

- internetist:

 asciinema play https://asciinema.org/a/faili-id

Kahekordse kiirusega (-s speed) vaatamine, enda masinasse üles pandud:

 asciinema play https://enos.itcollege.ee/~edmund/materials/terminal-recording-streaming/asciinema.cast -s 2

Olemuslikult tegemist tegelikult väikesemahulise tekstifailiga, mida asciinema suudab videona näidata. Seejuures on tekst video seest kopeeritav.

Kusjuures toetatud on ka kümnendmurrud kiiruse määramisel, nt -s 1.2 (koma asemel tuleb punkti kasutada).

Sama video üleval ka ametlikul lehel, samuti saab ise vaatamiskiirust määrata:

 asciinema play https://asciinema.org/a/403863 -s 2

Video üleslaadimiseks:

 asciinema upload failinimi.cast

Kui oma serverisse, siis vt allpool võimalus ka see seadistada

Juhul, kui Teil on plaanis ekraanil toimunu salvestada ning hiljem soov üles laadida, siis saab kasutada käskude jada, mis alustab salvestamist, võimaldab vaadata videot peale salvestuse lõppu ning laeb faili üles:

 asciinema rec demo.cast + asciinema play demo.cast + asciinema upload demo.cast

Videote vistutamiseks veebis leiab juhised siit (HTML, Markdown).

Oma salvestuste kustutamiseks või muutmiseks peab ennast tuvastama käsuga

 asciinema auth

Seadistamine

Arvuti võimalik siduda asciinema kontoga:

  asciinema auth

Antud käsk kuvab veebiaadressi kujul https://asciinema.org/connect/install-id, mille kaudu saab muuta enda salvestatud faile. Lisaks võimalik seadistada kasutaja koos kasutajanime, e-postiga mille aktiveerimiseks saadetakse e-postiga link. asciinema paigalduse ID asub failis $HOME/.config/asciinema/install-id ja seda ID'd kasutataksegi arvuti sidumisel veebikontoga.

Kasutades asciinemat teises arvutis, saab sama ID'd kasutada, kui soovitakse salvestuses sama kasutaja alla üles laadida.


Kui sama ID'd kasutada, ka siis tuleks see käsk (asciinema auth) vähemalt üks kord käivitada. Siis lihtsalt avatakse juba olemasolev konto ehk siis sisuliselt sama ID'ga (access token) saab ligi.

Valikulised argumendid:

 -c käivitab määratud käsu asemel kestprogrammi (shell)
 -t täpsustab salvestatud faili pealkirja
 -y mitte küsida kinnitust
 -h abi
 -v versiooniteave
 man asciinema (põhjalikum juhend)

Asciinema videosid ei pea ilmtingimata laadima asciinema.org lehele. On võimalik ka seadistada oma leht antud otstarbeks.

Asciinema lehe kood on avalikult kättesaadav siin: https://github.com/asciinema/asciinema-server

Lisa oma ~/.config/asciinema/config sätetefaili viide oma lehele:

 [api]
 url = http://asciinema.example.com

Salvestuste teisendamine pildifailiks

GIF

Alternatiivina, kui pole võimalust seadistada asciinema serverit ega kasutada avalikku serverit, siis on võimalik salvestusest luua GIF-fail. https://github.com/asciinema/asciicast2gif - see paistab siiski aegunud olema uue asciinema 2.x jaoks, mis uut failivormingut kasutab.

Lisateave ka animeeritud GIFi analoogide kohta. Eriti paljutõotav on Free Lossless Image Format (FLIF)

SVG

Siin on olemas

Sätted

Asciinema hoiab ligipääsu ID'd (sisuliselt UUID) eraldi failis

 $HOME/.config/asciinema/install-id

Esmase asciinema käivituse puhul luuakse ligipääsu ID (access token) ning salvestatakse antud faili, juhul kui seda pole tehtud samas arvutis varem või varasemalt loodud ID sinna ise salvestatud. Kui ise varasemalt loodud ID sinna pandud, siis kasutatakse seda kuid käivitada on igal juhul vähemalt üks kord vaja arvuti sidumiseks olemasoleva kasutajaprofiiliga asciinema.org veebis.

Üldjuhul eraldi sätetefaili asukoht on:

 $HOME/.config/asciinema/config

Seda asukohta saab muuta keskkonnamuutuja $ASCIINEMA_CONFIG_HOME abil.

Kui $XDG_CONFIG_HOME on määratud, siis asciinema kasutab $XDG_CONFIG_HOME/asciinema ja mitte $HOME/.config/asciinema

Ennem stdin lubamist tasub lugeda seda postitust.

Automaatselt loodud fail näeb välja selliselt

 ; API server URL, default: https://asciinema.org
 ; If you run your own instance of asciinema-server then set its address here
 ; It can also be overriden by setting ASCIINEMA_API_URL environment variable
 ;url = https://asciinema.example.com

Sätetefailis on võimalik seadistada täiendavalt:

 [record]
 ; Command to record, default: $SHELL
 command = /bin/bash -l
 ; Enable stdin (keyboard) recording, default: no
 ;stdin = yes
 ; List of environment variables to capture, default: SHELL,TERM
 env = SHELL,TERM,USER
 ; Limit recorded terminal inactivity to max n seconds, default: off
 idle_time_limit = 3
 ; Answer "yes" to all interactive prompts, default: no
 yes = true
 ; Be quiet, suppress all notices/warnings, default: no
 quiet = true
 [play]
 ; Playback speed (can be fractional), default: 1
 speed = 2
 ; Limit replayed terminal inactivity to max n seconds, default: off
 ;idle_time_limit = 1

Täiendavat teavet seadistamise kohta leiab aadressilt: https://asciinema.org/docs/config

Teksti automaatsisestus

Antud viited toimivad Linuxis. MS Windowsile tuleb veel lahendused leida.

Kokkuvõtte ja teised võimalused

Tegemist on kasuliku lahendusega ekraanil toimuva salvestamiseks ning jagamiseks ning ei salvesta sisestatavaid paroole sessiooni ajal. Tööriist on kasulik kui soovitakse teha kas õppevideosi, koostada juhendeid või jagada informatsiooni. Aciinema ei ole ainuvõimalus on ka teisi rakendusi sarnase funktsionaalsusega.

Näiteks:

 "ttyrec" - https://www.howtoforge.com/tutorial/how-to-record-your-terminal-session-on-linux/
 "bsdutils" - https://www.linuxnix.com/record-terminalshell-session-linux/
 "shelr" - https://www.techrepublic.com/blog/linux-and-open-source/record-and-share-your-terminal-session-with-shelrtv/
 "TermRecord" - http://xmodulo.com/record-replay-terminal-session-linux.html

jne..

Autorid

Edmund Laugasson, märts 2021, artikli kaasajastamine

Aleksandra Sepp, AK21, november 2017, artikli täiendamine, versioon 2.0

Amagi, jaanuar 2017, versioon 1.0

Viited

https://asciinema.org ja näited salvestustest https://asciinema.org/explore

https://blog.asciinema.org/post/two-point-o/ - Asciinema v2.0

https://discourse.asciinema.org/ - arutelu

https://github.com/asciinema/asciinema - klientprogramm salvestamiseks

https://github.com/asciinema/asciinema-player - veebipõhine videote esitamine

https://github.com/asciinema/asciinema-server - serveri pool oma serverisse paigaldamiseks

https://github.com/ibigbug/PowerSession - asciinema PowerShellile MS Windowsis

https://asciinema.org/~lvm - näited PowerShellis salvestamisest

https://discourse.asciinema.org/t/does-asciinema-record-the-passwords-i-type-during-recording-session/23 - kohe ei tasu standardsisendit (stdin) ehk klaviatuuri salvestamist lubada, salasõnad võivad lekkida

https://anavarre.net/working-with-the-cli-you-should-probably-start-using-asciinema/

https://linuxconfig.org/record-and-replay-terminal-session-with-asciinema-on-linux

https://alternativeto.net/software/asciinema/ - alternatiivid (väga head alternatiivi ei ole)

https://ezgif.com/help/alternative-animated-image-formats - alternatiivsed animeeritud pildifailide vormingud, eriti paljutõotav on Free Lossless Image Format (FLIF)

https://asciinema.org/a/153907 - Star Wars, Episode IV. New Hope