Welcome to asciinema! (old)

by asciinema 8 years ago

macOS ◆ xterm-256color ◆ bash 15961 views

stderred

stderr in red.

About

stderred hooks on write() and a family of stream functions (fwrite, fprintf, error…) from libc in order to colorize all stderr output that goes to terminal thus making it distinguishable from stdout. Basically it wraps text that goes to file with descriptor “2” with proper ANSI escape codes making text red.

It’s implemented as a shared library and doesn’t require recompilation of existing binaries thanks to preload/insert feature of dynamic linkers.

It’s supported on Linux (with LD_PRELOAD), FreeBSD (also LD_PRELOAD) and OSX (with DYLD_INSERT_LIBRARIES).

Watch this intro asciicast to see it in action.

Installation

Clone this repository:

$ git clone git://github.com/sickill/stderred.git
$ cd stderred

Important: In all cases below make sure that path to libstderred.so is absolute!

Linux and FreeBSD

Make sure you have cmake and the gcc toolchain required for compilation installed:

# Ubuntu
sudo apt-get install build-essential cmake

# Fedora
sudo yum install make cmake gcc gcc-c++

# FreeBSD
pkg install cmake

Build:

$ make

Export LD_PRELOAD variable in your shell’s config file by putting following in your .bashrc/.zshrc:

export LD_PRELOAD="/absolute/path/to/stderred/build/libstderred.so${LD_PRELOAD:+:$LD_PRELOAD}"

More by asciinema

qrenco.de 00:06

by asciinema 7 years ago featured

Star Wars: Episode IV 17:50

by asciinema 1 year ago featured

Welcome to asciinema! 01:59

by asciinema 4 years ago

Front page demo (inner) 00:40

by asciinema 9 years ago

See all

You can download this recording in asciicast v1 format, as a .json file.

Download

Replay in terminal

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

asciinema play 42383.json

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/42383.json',
      document.getElementById('player'),
      { cols: 81, rows: 20 }
    );
  </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/difqlgx86ym6emrmd8u62yqu8 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.