Frequently Asked Questions
How is it pronounced?
The word “asciinema” is a combination of English “ASCII” and Ancient Greek “κίνημα” (kínēma, “movement”).
Why am I getting
command not found at the begining of the recording session?
When recording asciinema starts new shell instance (as indicated by
environment variable) by default. It invokes
exec $SHELL, which in most
cases translates to
exec /bin/bash or
exec /bin/zsh. This means the shell
runs as an "interactive shell", but not as a "login shell".
If you have functions and/or other shell configuration defined in either
.profile file they are not loaded unless the
shell is started as a login shell.
Some terminal emulators do that (passing "-l" option to the shell command-line), some don't. asciinema doesn't.
Worry not, you have several options. You can:
- move this part of configuration to
- record with
asciinema rec -c "/bin/bash -l"or,
add the following setting to your
[record] command= /bin/bash -l
Why my shell prompt/theme isn't working during recording?
Why some of my custom shell functions are not available during recording?
Does it record the passwords I type during recording?
asciinema records only terminal output - everything that you can actually see in a terminal window. It doesn't record input (keys pressed). Some applications turn off "echo mode" when asking for a password, and because the passwords are not visible they are not recorded. Some applications display star characters instead of real characters and asciinema records only "******". However, some applications don't have any precautions and the actual password is visible to the user, and thus recorded by asciinema.
Can I embed the asciicast player on my blog?
Yes, see embedding docs.
How can I delete my asciicast?
In order to delete your asciicast you need to associate your local API token
(which was assigned to the recorded asciicast) with the asciinema.org
account. Just run
asciinema auth in your terminal and open the printed URL
in your browser. Once you sign in you'll see a "Delete" link on your
Can I have my own asciinema site instance?
Yes, you can set up your own asciinema site. The source code of the app that runs asciinema.org is available here.
When you have the site up and running you can easily tell asciinema client to use it by adding following setting to ~/.config/asciinema/config file:
[api] url = http://asciinema.example.com
Alternatively, you can set
ASCIINEMA_API_URL env variable:
ASCIINEMA_API_URL=http://asciinema.example.com asciinema rec
Can I edit/post-process the recorded asciicast?
Yes, if you know how to deal with ansi escape
sequences. Asciicasts are
self-contained JSON files which you can edit before uploading. Look at
stdout attribute in asciicast format doc