Preview of the new upload behavior in asciinema CLI 3.0

by ku1ik 10 months ago

xterm-256color ◆ fish 462 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 by ku1ik

untitled 00:16

by ku1ik 12 years ago

Kraków Devops Meetup #2 - example 3 00:31

by ku1ik 10 years ago

untitled 00:44

by ku1ik 11 years ago

Aker brygge in true color 00:24

by ku1ik 8 years ago

See all

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

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="asciinema-player.css" />
</head>
<body>
  <div id="player"></div>
  <script src="asciinema-player.min.js"></script>
  <script>
    AsciinemaPlayer.create(
      '/assets/628515.cast',
      document.getElementById('player'),
      { cols: 80, rows: 24 }
    );
  </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

Or, if you already downloaded the recording file:

agg demo.cast demo.gif

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.