tldr command - manpages which get to the point

by picockpit 3 years ago

GNU/Linux ◆ xterm ◆ bash 130 views

Ever get tired of hunting for simple examples in the very elaborate manpages you get with tools like tar, gzip and so on?

tldr is here to solve the problem - it gives you really useful examples you can run to work magic on your command line today.

Part of our compilation of “Ultimate List of unusual but really useful Linux shell commands”, which you can check out here:

https://picockpit.com/raspberry-pi/ultimate-list-of-unusual-but-really-useful-linux-shell-commands/

More by picockpit

lolcat examples 00:34

by picockpit 3 years ago

mtr - a modern traceroute and ping tool 00:47

by picockpit 3 years ago

rig - a tool to create fake identities 00:07

by picockpit 3 years ago

bat - a syntax highlighting alternative to cat 00:23

by picockpit 3 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 377540.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/377540.cast',
      document.getElementById('player'),
      { cols: 71, rows: 18 }
    );
  </script>
</body>
</html>

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

While this site doesn't offer 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 run the following command to create GIF file:

agg https://asciinema.org/a/377540 377540.gif

Or, if you already downloaded the recording file:

agg 377540.cast 377540.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.