Preview of the new upload behavior in asciinema CLI 3.0

by ku1ik 2 years ago

xterm-256color • fish 640 views

The change from 2.x is that it now requires opt-in / confirmation to use asciinema.org as the default asciinema server.

The server URL configuration step lets you enter your own self-hosted asciinema server URL.

Also, it’s now possible to pass a server URL as the 2nd arg to the asciinema upload, e.g. asciinema upload demo.cast https://asciinema.example.com to override the default target, for each upload.

As before, you’ll be able to set the server URL in the config file as well.

Update: in the latest version in develop branch the custom asciinema server URL is now a global option instead of a positional argument.

Instead of passing it as shown in the demo above it’s now used like this:

asciinema --server-url https://asciinema.example.com upload demo.cast

asciinema --server-url https://asciinema.example.com auth

More recordings by ku1ik

Browse all

Nyan Cat! 1:04

by ku1ik 14 years ago featured

untitled 0:12

by ku1ik 9 years ago

iex-with-deps 0:36

by ku1ik 6 years ago

Steam Locomotive FTW!!!!!!!111 0:19

by ku1ik 14 years ago featured

https://asciinema.org/a/Ry4cnZr5VHFIBRbmk9XBld5To

Copied!

Append ?t=30 to start the playback at 30s, ?t=3:20 to start the playback at 3m 20s.

See sharing docs for more link customization options.

Embed as image link

Use snippets below to display a preview image linking to this recording.
Ideal for places where scripts are not allowed, such as project README files.

HTML:

<a href="https://asciinema.org/a/Ry4cnZr5VHFIBRbmk9XBld5To" target="_blank"><img src="https://asciinema.org/a/Ry4cnZr5VHFIBRbmk9XBld5To.svg" /></a>

Copied!

Markdown:

[![asciicast](https://asciinema.org/a/Ry4cnZr5VHFIBRbmk9XBld5To.svg)](https://asciinema.org/a/Ry4cnZr5VHFIBRbmk9XBld5To)

Copied!

Embed the player

If you're embedding on your own page or on a site which permits script tags, you can use the full player widget:

<script src="https://asciinema.org/a/Ry4cnZr5VHFIBRbmk9XBld5To.js" id="asciicast-Ry4cnZr5VHFIBRbmk9XBld5To" async="true"></script>

Copied!

Paste the above script tag where you want the player to be displayed on your page.

See embedding docs for more player customization options.

You can download this recording in asciicast v2 format, as a .cast file.

Download

Replay in terminal

You can replay the downloaded recording in your terminal using the asciinema play command:

asciinema play 628515.cast

Copied!

If you don't have asciinema CLI installed then see installation instructions.

Use with stand-alone player on your website

Download asciinema player from the releases page (you only need .js and .css file), then use it like this:

<!DOCTYPE html>
<html>
<head>
  <link rel="stylesheet" type="text/css" href="/assets/asciinema-player.css" />
</head>
<body>
  <div id="player"></div>
  <script src="/assets/asciinema-player.min.js"></script>
  <script>
    // @license magnet:?xt=urn:btih:8e4f440f4c65981c5bf93c76d35135ba5064d8b7&dn=apache-2.0.txt Apache-2.0
    AsciinemaPlayer.create(
      '/assets/628515.cast',
      document.getElementById('player'),
      { cols: 80, rows: 24 }
    );
    // @license-end
  </script>
</body>
</html>

See asciinema player quick-start guide for full usage instructions.

While this site doesn't provide GIF conversion at the moment, you can still do it yourself with the help of asciinema GIF generator utility - agg.

Once you have it installed, generate a GIF with the following command:

agg https://asciinema.org/a/Ry4cnZr5VHFIBRbmk9XBld5To demo.gif

Copied!

Or, if you already downloaded the recording file:

agg demo.cast demo.gif

Copied!

Check agg --help for all available options. You can change font family and size, select color theme, adjust speed and more.

See agg manual for full usage instructions.