Live data from Hacker News

Asciinema – Record and share terminal sessions

asciinema.org

11–20 of 103 posts

Re: Asciinema – Record and share terminal sessions

#11

I tried using asciienema for a blog post. I forget exactly why I gave up on it. Something about it frustrated me and didn’t work right. I ended up using OBS to make a screen capture. Now I have an MP4 that plays in a vanilla html5 video tag and will work forever.

One killer feature you get with asciinema & not with an MP4 is that people watching it can copy & paste from your recording. So they don't have to type out the same command you typed, they can just copy it into their terminal directly

Re: Asciinema – Record and share terminal sessions

#13
post #9

If you feel like using asciinema or similar on your readme - please consider using plain text instead. This fancy players: - are unfriendly to visually impaired people - are unfriendly to the many people with low bandwith in the global south - require you to watch the play instead of scanning through text with your eyes - cannot be searched for text strings easily - cannot be easily used in a terminal or without a br…

Thank you for making this point. Plain text is really underappreciated. When I visit a project README, I don't want to wait for the entire replay. I just to skip to the part of the documentation that is relevant to me.

A short asciinema replay can be useful for a quick demo buy don't let that substitute your text documentation. I may watch the replay only once but I will come back to a well written documentation again and again.

Re: Asciinema – Record and share terminal sessions

#14
post #3

Are there any alternatives (just want to see alternatives to find which is best for my use). Either way, looks nice! Although a bit irrelevant, like the gradient!

script / scriptreplay, maybe. That's what I've used at home when I want to capture output.

Re: Asciinema – Record and share terminal sessions

#15
post #11

I tried using asciienema for a blog post. I forget exactly why I gave up on it. Something about it frustrated me and didn’t work right. I ended up using OBS to make a screen capture. Now I have an MP4 that plays in a vanilla html5 video tag and will work forever.

One killer feature you get with asciinema & not with an MP4 is that people watching it can copy & paste from your recording. So they don't have to type out the same command you typed, they can just copy it into their terminal directly

Just provide the commands again as text. I don't have to wait for the entire asciinema to replay. I can ctrl+f what I need and copy-paste.

Re: Asciinema – Record and share terminal sessions

#16
post #9

If you feel like using asciinema or similar on your readme - please consider using plain text instead. This fancy players: - are unfriendly to visually impaired people - are unfriendly to the many people with low bandwith in the global south - require you to watch the play instead of scanning through text with your eyes - cannot be searched for text strings easily - cannot be easily used in a terminal or without a br…

I am using asciinema there: https://github.com/turtlequeue/quickstart-js

I think it makes sense in this case because one terminal "speaks" to another. I agree with your assessment about plain text - do you think there is a good way to present this kind of workflow using plain text?

Re: Asciinema – Record and share terminal sessions

#17
post #9

If you feel like using asciinema or similar on your readme - please consider using plain text instead. This fancy players: - are unfriendly to visually impaired people - are unfriendly to the many people with low bandwith in the global south - require you to watch the play instead of scanning through text with your eyes - cannot be searched for text strings easily - cannot be easily used in a terminal or without a br…

Uploading ascii equivalents is a great idea! I usually do that, so I can later reconvert if needed.

Can you tell me if your text browser/Braille reader works well with https://github.com/csdvrx/pg_csdvrx/blob/master/pg_csdvrx.tt... ?

This is my latest recording. I removed color and unicode to be more accessible but I still have some Ansi.

Re: Asciinema – Record and share terminal sessions

#18
Let me be the devil advocate: why not use ttyrec + seq2gif instead? Or check https://intoli.com/blog/terminal-recorders/ if you don't like my recommendation

ttyrec is a standard format that most people and tools understand.

And if you want something fancy that asciinema output, you can use seq2gif which support all the bells n whistles asciinema does, while allowing you to also upload the ttyrec file.

However, I would suggest not using unicode or Ansi color in your recordings.

You want to demo a feature, not show your cool terminal or the amazing gif you made. The gif is just a byproduct. Keeping to plain text as much as possible makes your recording available to people using text terminals and Braille screen readers.

My most recent example: https://github.com/csdvrx/pg_csdvrx/raw/master/pg_csdvrx.tty... and https://github.com/csdvrx/pg_csdvrx/raw/master/pg_csdvrx.gif

(in case you wonder why I'm doing a cat /dev/random into a live postgres database block file, this is to show how I can recover the database content from the raw directory. Kids, don't try this at home. Don't try it at your parents work on their production database either. In fact, just don't do that, it is only for when your database ends up in /lost+found)

Re: Asciinema – Record and share terminal sessions

#19
post #7
post #3

Are there any alternatives (just want to see alternatives to find which is best for my use). Either way, looks nice! Although a bit irrelevant, like the gradient!

ttyrec and ttyplay This plays back in the terminal, not in something you can put on the web as easily.

It does that too with seq2gif.

Re: Asciinema – Record and share terminal sessions

#20
post #11

I tried using asciienema for a blog post. I forget exactly why I gave up on it. Something about it frustrated me and didn’t work right. I ended up using OBS to make a screen capture. Now I have an MP4 that plays in a vanilla html5 video tag and will work forever.

One killer feature you get with asciinema & not with an MP4 is that people watching it can copy & paste from your recording. So they don't have to type out the same command you typed, they can just copy it into their terminal directly

Not what I'd consider a killer feature, but it's definitely one of the advantages.

Now, what is killer is that the recording is just a text file, so I can edit it and check it in to my source control system, rather than having to mangle some screen recording environment and check in a binary blob that's hard/impossible to edit in the future.

It's also pretty universally guaranteed to work since it doesn't demand much of the browser as far as weird javascript features go, and means I can deliver a whole screen recording in the fraction of the size of an MP4 file. It's screen resolution agnostic, making it more functional for a wider class of users than a video. I also don't have to ship a different version of the recording if I want a high contrast version for accessibility reasons.

So, yeah, plenty of reasons to use asciinema over a conventional screen recording.

Post reply on HN