# Help

**URL:** https://discourse.asciinema.org/c/help/7.md

[Latest](https://discourse.asciinema.org/latest.md) · [Categories](https://discourse.asciinema.org/categories.md) · [Tags](https://discourse.asciinema.org/tags.md)

---

## [About the Help category](https://discourse.asciinema.org/t/about-the-help-category/15)

<div class="topic-metadata">

**Author:** [@ku1ik](https://discourse.asciinema.org/u/ku1ik)\
**Replies:** 0

</div>

Use the help category to ask for help or if you have general usage or setup questions.

---

## [This recorder token belongs to a different user](https://discourse.asciinema.org/t/this-recorder-token-belongs-to-a-different-user/313)

<div class="topic-metadata">

**Author:** [@ernie18a](https://discourse.asciinema.org/u/ernie18a)\
**Replies:** 3\
**Last updated:** [June 16, 2026, 3:38pm UTC](https://discourse.asciinema.org/t/this-recorder-token-belongs-to-a-different-user/313 "2026-06-16T15:38:02Z")

</div>

logout from asciinema.org run asciinema auth and clicked the url enter my email and open mail box and click on the mail sent from hello@asciinema.org clicked the url from email saw the “This recorder token belongs to …

---

## [Sharing Thumbnail (svg) Font Family does not appear from Terminal font family settings](https://discourse.asciinema.org/t/sharing-thumbnail-svg-font-family-does-not-appear-from-terminal-font-family-settings/1046)

<div class="topic-metadata">

**Author:** [@nathanielvarona](https://discourse.asciinema.org/u/nathanielvarona)\
**Replies:** 3\
**Last updated:** [December 16, 2025, 4:43pm UTC](https://discourse.asciinema.org/t/sharing-thumbnail-svg-font-family-does-not-appear-from-terminal-font-family-settings/1046 "2025-12-16T16:43:23Z")

</div>

I have this issue with the cast I uploaded recently dotfiles: tmuxp - lazyvim - tree-sitter - lspconfig - lazygit - asciinema.org Main page shows correct Thumbnail Preview (svg). What I mean correct is it follows the Fo…

---

## [Single Image Output / Non-interactive "poster" mode](https://discourse.asciinema.org/t/single-image-output-non-interactive-poster-mode/915)

<div class="topic-metadata">

**Author:** [@kai-tub](https://discourse.asciinema.org/u/kai-tub)\
**Replies:** 6\
**Last updated:** [December 3, 2025, 2:34am UTC](https://discourse.asciinema.org/t/single-image-output-non-interactive-poster-mode/915 "2025-12-03T02:34:36Z")

</div>

Hey all :wave: I am a big fan of asciinema! Thanks for all of the hard work :heart: I am using a self-hosted asciicast for a documentation page I am working on. I like the new marker feature, but it has led me to the f…

---

## [Is it possible to "script" asciinema?](https://discourse.asciinema.org/t/is-it-possible-to-script-asciinema/416)

<div class="topic-metadata">

**Author:** [@joelmccracken](https://discourse.asciinema.org/u/joelmccracken)\
**Replies:** 17\
**Last updated:** [November 27, 2025, 9:43pm UTC](https://discourse.asciinema.org/t/is-it-possible-to-script-asciinema/416 "2025-11-27T21:43:51Z")

</div>

So something I’ve always wanted is the ability to “script” a video, so that all i have to do is edit the script file then regenerate the video. I think I could hack this together by using shell-mode in emacs and then wr…

---

## [V3 cli play equivalent for v2.2 play --stream=i option](https://discourse.asciinema.org/t/v3-cli-play-equivalent-for-v2-2-play-stream-i-option/1049)

<div class="topic-metadata">

**Author:** [@Pam](https://discourse.asciinema.org/u/Pam)\
**Replies:** 0\
**Last updated:** [November 16, 2025, 5:10am UTC](https://discourse.asciinema.org/t/v3-cli-play-equivalent-for-v2-2-play-stream-i-option/1049 "2025-11-16T05:10:07Z")

</div>

In the blog post What's new in asciinema - part II: the recorder · asciinema blog there was a new feature for v2.2 asciinema rec --stdin demo.cast asciinema play --stream=i demo.cast | asciinema rec new.cast With the v…

---

## [Pausing VMs kills recording](https://discourse.asciinema.org/t/pausing-vms-kills-recording/1002)

<div class="topic-metadata">

**Author:** [@Cyb3rC3lt](https://discourse.asciinema.org/u/Cyb3rC3lt)\
**Replies:** 11\
**Last updated:** [August 28, 2025, 7:08am UTC](https://discourse.asciinema.org/t/pausing-vms-kills-recording/1002 "2025-08-28T07:08:27Z")

</div>

Hi there, Just wondering is there any workaround for when I pause my VM for the day and when I reopen it the following day all my recordings are dead. I tried pausing the recording and unpausing the recording after the …

---

## [Asciinema self-hosted server administrative-tasks](https://discourse.asciinema.org/t/asciinema-self-hosted-server-administrative-tasks/650)

<div class="topic-metadata">

**Author:** [@alexgreen](https://discourse.asciinema.org/u/alexgreen)\
**Replies:** 2\
**Last updated:** [August 27, 2025, 2:32pm UTC](https://discourse.asciinema.org/t/asciinema-self-hosted-server-administrative-tasks/650 "2025-08-27T14:32:25Z")

</div>

Hi guys. I’ve been deployed the asciinema server in my organizations (with SSL support) The documentation says I have the ability to manage recordings: I added the user email to admin: docker-compose run --rm phoeni…

---

## [Local copy of new 'stream' function](https://discourse.asciinema.org/t/local-copy-of-new-stream-function/815)

<div class="topic-metadata">

**Author:** [@vsandstrom](https://discourse.asciinema.org/u/vsandstrom)\
**Replies:** 3\
**Last updated:** [May 29, 2025, 1:31pm UTC](https://discourse.asciinema.org/t/local-copy-of-new-stream-function/815 "2025-05-29T13:31:49Z")

</div>

Is it possible to save the session of a stream locally? Since it isn’t possible to replay a stream, it would be nice to be able to upload it after the stream has finished. Is this possible already and I have missed a co…

---

## [How to remove pauses?](https://discourse.asciinema.org/t/how-to-remove-pauses/996)

<div class="topic-metadata">

**Author:** [@AIstEReM](https://discourse.asciinema.org/u/AIstEReM)\
**Replies:** 1\
**Last updated:** [June 1, 2025, 7:10am UTC](https://discourse.asciinema.org/t/how-to-remove-pauses/996 "2025-06-01T07:10:33Z")

</div>

Greetings. I needed to get rid of pauses that were longer than two seconds. Can anyone tell me how to do this? With asciinema-edit it could be done with the quantize --range parameter, but unfortunately the processed fi…

---

## [Rationale for Timestamps in .cast format](https://discourse.asciinema.org/t/rationale-for-timestamps-in-cast-format/657)

<div class="topic-metadata">

**Author:** [@a2800276](https://discourse.asciinema.org/u/a2800276)\
**Replies:** 1\
**Last updated:** [May 29, 2025, 1:35pm UTC](https://discourse.asciinema.org/t/rationale-for-timestamps-in-cast-format/657 "2025-05-29T13:35:05Z")

</div>

I’m struggling to edit some cast files and wondering why the timestamp is an offset to the beginning. For editing it would be much easier to just record the timestamp to the previous frame and in general that would make …

---

## [2 Questions; 1 post](https://discourse.asciinema.org/t/2-questions-1-post/920)

<div class="topic-metadata">

**Author:** [@J\_Scott\_Elblein](https://discourse.asciinema.org/u/J_Scott_Elblein)\
**Replies:** 4\
**Last updated:** [May 29, 2025, 1:26pm UTC](https://discourse.asciinema.org/t/2-questions-1-post/920 "2025-05-29T13:26:46Z")

</div>

NOTE: I tried to make this 2 different threads, but the forum said I was blocked from posting for 24 hours due to “too many posts”; so I’m just adding them both to 1 post :point\_right:Port 4002? Admin Endpoint? Looking…

---

## [Export frame to html](https://discourse.asciinema.org/t/export-frame-to-html/968)

<div class="topic-metadata">

**Author:** [@Ian](https://discourse.asciinema.org/u/Ian)\
**Replies:** 2\
**Last updated:** [May 26, 2025, 11:56am UTC](https://discourse.asciinema.org/t/export-frame-to-html/968 "2025-05-26T11:56:45Z")

</div>

Hello, Really enjoying asciinema. I wrote a python script that automates screencasts and marker placements to auto update docs for a serial terminal device. The script writes the v2 asciinema format directly, and I use …

---

## [Markers in rc4 not working (but version 2 works)](https://discourse.asciinema.org/t/markers-in-rc4-not-working-but-version-2-works/991)

<div class="topic-metadata">

**Author:** [@tacman](https://discourse.asciinema.org/u/tacman)\
**Replies:** 2\
**Last updated:** [May 25, 2025, 3:24pm UTC](https://discourse.asciinema.org/t/markers-in-rc4-not-working-but-version-2-works/991 "2025-05-25T15:24:28Z")

</div>

My hotkey to save markers doesn’t seem to be working in rc4. cat ~/.config/asciinema/config \[api\] ; url = https://asciinema.example.com \[record\] ; Define hotkey for adding a marker, default: none add\_marker\_key = C-…

---

## [Gmail SMTP config not working?](https://discourse.asciinema.org/t/gmail-smtp-config-not-working/918)

<div class="topic-metadata">

**Author:** [@J\_Scott\_Elblein](https://discourse.asciinema.org/u/J_Scott_Elblein)\
**Replies:** 1\
**Last updated:** [January 18, 2025, 2:06am UTC](https://discourse.asciinema.org/t/gmail-smtp-config-not-working/918 "2025-01-18T02:06:44Z")

</div>

Hey all, So, I’m giving the server app a try on my own docker setup, and the SMTP config is failing even though it’s a common group of settings I’ve used for several other containers: SMTP\_HOST: 'smtp.gmail.com' …

---

## [Changing the server instance name](https://discourse.asciinema.org/t/changing-the-server-instance-name/872)

<div class="topic-metadata">

**Author:** [@lucie](https://discourse.asciinema.org/u/lucie)\
**Replies:** 6\
**Last updated:** [November 12, 2024, 10:12pm UTC](https://discourse.asciinema.org/t/changing-the-server-instance-name/872 "2024-11-12T22:12:55Z")

</div>

Hi, I have just set up my new instance of Asciinema, but I’m noticing that the server calls itself “127.0.0.1”. For example, this is an excerpt from the about page: About 127.0.0.1 127.0.0.1 is a platform for hosting…

---

## [SSL: CERTIFICATE\_VERIFY\_FAILED on macOS 10.12.6](https://discourse.asciinema.org/t/ssl-certificate-verify-failed-on-macos-10-12-6/862)

<div class="topic-metadata">

**Author:** [@ok-coder1](https://discourse.asciinema.org/u/ok-coder1)\
**Replies:** 3\
**Last updated:** [October 10, 2024, 10:11am UTC](https://discourse.asciinema.org/t/ssl-certificate-verify-failed-on-macos-10-12-6/862 "2024-10-10T10:11:21Z")

</div>

Hi, I installed asciinema via pip3 but when I try to upload a recording this comes up: Users-iMac:~ User$ asciinema upload demo.cast asciinema: upload failed: \<urlopen error \[SSL: CERTIFICATE\_VERIFY\_FAILED\] certificat…

---

## [Add Markers with Title from CLI](https://discourse.asciinema.org/t/add-markers-with-title-from-cli/861)

<div class="topic-metadata">

**Author:** [@cmprmsd](https://discourse.asciinema.org/u/cmprmsd)\
**Replies:** 3\
**Last updated:** [September 18, 2024, 7:24pm UTC](https://discourse.asciinema.org/t/add-markers-with-title-from-cli/861 "2024-09-18T19:24:53Z")

</div>

Hey there! Is it possible to label the markers from CLI? I only found the hotkey “add\_marker\_key = C-x”, which adds markers, but I want to add them programmatically. My use case is for each new prompt line I want to s…

---

## [Colors in neovim not shown](https://discourse.asciinema.org/t/colors-in-neovim-not-shown/363)

<div class="topic-metadata">

**Author:** [@ntd](https://discourse.asciinema.org/u/ntd)\
**Replies:** 15\
**Last updated:** [June 25, 2024, 12:32pm UTC](https://discourse.asciinema.org/t/colors-in-neovim-not-shown/363 "2024-06-25T12:32:37Z")

</div>

Hi all, I just uploaded my first asciinema cast: https://asciinema.org/a/zNLcS20lFtzuL0pDkVXPQwfc1 The problem is vim (neovim 0.4.3 to be accurate) is shown somewhat monochrome but it is not. The following screenshot …

---

## [Why a private video can be seen?!](https://discourse.asciinema.org/t/why-a-private-video-can-be-seen/564)

<div class="topic-metadata">

**Author:** [@somera](https://discourse.asciinema.org/u/somera)\
**Replies:** 13\
**Last updated:** [May 19, 2024, 6:54pm UTC](https://discourse.asciinema.org/t/why-a-private-video-can-be-seen/564 "2024-05-19T18:54:24Z")

</div>

Hi, in my profile is Asciicast visibilty set to private. On the on specific asciicast I see “private”. But I can see his whole asciicast with other browser. That means → this is public. Shouln’t this be not possible? T…

---

## [Configuring asciinema-server to Connect to PostgreSQL via Unix Domain Socket](https://discourse.asciinema.org/t/configuring-asciinema-server-to-connect-to-postgresql-via-unix-domain-socket/827)

<div class="topic-metadata">

**Author:** [@yusum](https://discourse.asciinema.org/u/yusum)\
**Replies:** 2\
**Last updated:** [May 19, 2024, 9:59am UTC](https://discourse.asciinema.org/t/configuring-asciinema-server-to-connect-to-postgresql-via-unix-domain-socket/827 "2024-05-19T09:59:34Z")

</div>

Hello everyone, I’m currently exploring how to configure asciinema-server to connect to PostgreSQL using a Unix domain socket, but I’m facing some challenges. Despite searching extensively, I couldn’t find any documenta…

---

## [Password protect links](https://discourse.asciinema.org/t/password-protect-links/804)

<div class="topic-metadata">

**Author:** [@gcs8](https://discourse.asciinema.org/u/gcs8)\
**Replies:** 5\
**Last updated:** [May 19, 2024, 8:54am UTC](https://discourse.asciinema.org/t/password-protect-links/804 "2024-05-19T08:54:59Z")

</div>

Hey, I am self-hosting, I would like a bit more opsec here. Is there an easy way to set a random password on links I share or tie view permissions to account(s) or email domains? I would also love to have an admin view …

---

## [How does asciinema capture and reinterpret colors?](https://discourse.asciinema.org/t/how-does-asciinema-capture-and-reinterpret-colors/283)

<div class="topic-metadata">

**Author:** [@bradcray](https://discourse.asciinema.org/u/bradcray)\
**Replies:** 2\
**Last updated:** [April 20, 2024, 3:54pm UTC](https://discourse.asciinema.org/t/how-does-asciinema-capture-and-reinterpret-colors/283 "2024-04-20T15:54:57Z")

</div>

Hi Asciinema — First, thanks for this terrific piece of technology—I love it! I’m trying to better understand how the colors displayed in my terminal during recording relate to those that are used during playback. Fro…

---

## [Tool for splicing asciinema clips together?](https://discourse.asciinema.org/t/tool-for-splicing-asciinema-clips-together/284)

<div class="topic-metadata">

**Author:** [@bradcray](https://discourse.asciinema.org/u/bradcray)\
**Replies:** 6\
**Last updated:** [April 20, 2024, 3:35pm UTC](https://discourse.asciinema.org/t/tool-for-splicing-asciinema-clips-together/284 "2024-04-20T15:35:41Z")

</div>

Hi Asciinema community — I’m curious whether anyone has a tool or script that can splice asciinema clips together? I understand that I can use the rec --append option to extend an existing clip with a new recording. B…

---

## [Is there a way to specify a nerdfont?](https://discourse.asciinema.org/t/is-there-a-way-to-specify-a-nerdfont/626)

<div class="topic-metadata">

**Author:** [@ctranstrum](https://discourse.asciinema.org/u/ctranstrum)\
**Replies:** 1\
**Last updated:** [April 20, 2024, 3:29pm UTC](https://discourse.asciinema.org/t/is-there-a-way-to-specify-a-nerdfont/626 "2024-04-20T15:29:30Z")

</div>

My recording looks pretty terrible, and I imagine it’s because I have installed a NerdFont locally and the default font on the website is not a NerdFont. Maybe there’s a good reason not to use a NerdFont by default, but …

---

## [Auto Run And Record](https://discourse.asciinema.org/t/auto-run-and-record/645)

<div class="topic-metadata">

**Author:** [@nimafanniasl](https://discourse.asciinema.org/u/nimafanniasl)\
**Replies:** 2\
**Last updated:** [April 20, 2024, 3:22pm UTC](https://discourse.asciinema.org/t/auto-run-and-record/645 "2024-04-20T15:22:52Z")

</div>

Hello I Have A Virtual machine That I Connect To With ssh! I Want When A Bash Started, Recording Starts! When I put the command in bashrc, every time a bash is executed, an infinite loop is created that starts recordin…

---

## [Sign up email doesn't come](https://discourse.asciinema.org/t/sign-up-email-doesnt-come/664)

<div class="topic-metadata">

**Author:** [@NatashaElistratova](https://discourse.asciinema.org/u/NatashaElistratova)\
**Replies:** 17\
**Last updated:** [January 17, 2024, 10:52pm UTC](https://discourse.asciinema.org/t/sign-up-email-doesnt-come/664 "2024-01-17T22:52:20Z")

</div>

Hello. I’m trying to sign up second day in a row, but Sign up email doesn’t come.

---

## [Archived links retrieval](https://discourse.asciinema.org/t/archived-links-retrieval/182)

<div class="topic-metadata">

**Author:** [@coulon](https://discourse.asciinema.org/u/coulon)\
**Replies:** 9\
**Last updated:** [December 20, 2023, 11:12am UTC](https://discourse.asciinema.org/t/archived-links-retrieval/182 "2023-12-20T11:12:51Z")

</div>

I am a teacher and I have lost about twenty records that have been archived. I kept all the links. Is there a way to get them back?

---

## [My recording is archived](https://discourse.asciinema.org/t/my-recording-is-archived/194)

<div class="topic-metadata">

**Author:** [@markroxor](https://discourse.asciinema.org/u/markroxor)\
**Replies:** 0\
**Last updated:** [March 19, 2019, 11:51am UTC](https://discourse.asciinema.org/t/my-recording-is-archived/194 "2019-03-19T11:51:22Z")

</div>

My recording was archived - untitled - asciinema.org can you bring it back as I dont have any means of regenerating it at the moment. I wasnt aware of your archiving policy.

---

## [Artifacting on asciinema.org - looks good in CLI player](https://discourse.asciinema.org/t/artifacting-on-asciinema-org-looks-good-in-cli-player/763)

<div class="topic-metadata">

**Author:** [@weitzman](https://discourse.asciinema.org/u/weitzman)\
**Replies:** 1\
**Last updated:** [November 23, 2023, 4:51pm UTC](https://discourse.asciinema.org/t/artifacting-on-asciinema-org-looks-good-in-cli-player/763 "2023-11-23T16:51:29Z")

</div>

See the 30 second mark at drush entity:create - asciinema. I edit the line with ‘field\_number\_of\_servings’ but the line above starts to obscure it - field\_media\_image. This artifacting does not happen when I play in my C…

[Next page](https://discourse.asciinema.org/c/help/7.md?page=1)