Responsive Directory Truncation in Powerlevel10k

by romka 5 years ago

GNU/Linux ◆ xterm-256color ◆ zsh 6115 views

Powerlevel10k is a theme for ZSH. This screencast shows how it can truncate your current directory to make it fit on the prompt line.

When the terminal window is wide enough, the full directory is displayed.

~/work/projects/repos/skynet/src/ai/terminator/models/T-800

If the full directory doesn’t fit, the leftmost segment gets truncated to its shortest unique prefix. ~/work becomes ~/wo. It cannot be truncated to ~/w because there is ~/wireguard and thus ~/w would be ambiguous.

Two segments in this directory are important and never get truncated: skynet, because it’s a root of a Git repository; and T-800, because it’s the last segment.

Directory segments are shown in one of 3 colors:

Important segments are bright.
Truncated segment are bleak.
Regular segment (not truncated but can be) use in-between color.

(It’s difficult to distinguish these colors on asciinema.org. Rest assured they are customizable, so you can get any level of contrast you like.)

After several rounds of truncation the directory turns into ~/wo/p/r/skynet/s/a/t/m/T-800 and cannot be shortened any further. If it still doesn’t fit on the prompt line, right prompt gets hidden.

Truncated directories can be tab-completed to their original values. Typing ~/wo/p/r/skynet/s/a/t/m/T-800<TAB> yields ~/work/projects/repos/skynet/src/ai/terminator/models/T-800/.

Try it out:

git clone https://github.com/romkatv/powerlevel10k.git ~/powerlevel10k
echo 'source ~/powerlevel10k/powerlevel10k.zsh-theme' >>! ~/.zshrc

Restart zsh and type p10k configure.

Alternative installation methods available.

More by romka

Powerlevel10k Configuration Wizard 00:24

by romka 5 years ago

Powerline Status ZSH vs Powerlevel10k 00:36

by romka 5 years ago

Zsh prompt always at bottom 00:33

by romka 4 years ago

Spaceship vs Powerlevel10k 00:37

by romka 5 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 258376.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/258376.cast',
      document.getElementById('player'),
      { cols: 94, rows: 33 }
    );
  </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/258376 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.