Go to file
2022-07-28 12:06:06 +02:00
.github/workflows Add CI with Github Actions 2022-05-31 11:40:22 +02:00
bin Add CI with Github Actions 2022-05-31 11:40:22 +02:00
img Update screenshot 2022-01-05 19:24:55 +01:00
.gitignore Add gitignore 2021-05-02 17:59:32 +02:00
Cask Add CI with Github Actions 2022-05-31 11:40:22 +02:00
CONTRIBUTING.org README update, add CONTRIBUTING 2021-05-23 02:15:12 +02:00
eshell-info-banner.el Add an option to exclude some partitions 2022-07-28 12:06:06 +02:00
LICENSE Fix license issue 2021-11-11 00:07:13 +01:00
Makefile Add CI with Github Actions 2022-05-31 11:40:22 +02:00
README.org Add new variables to the README 2022-07-28 12:06:06 +02:00


https://melpa.org/packages/eshell-info-banner-badge.svg https://stable.melpa.org/packages/eshell-info-banner-badge.svg https://github.com/Phundrak/eshell-info-banner.el/actions/workflows/workflow.yml/badge.svg


eshell-info-banner.el is a utility for creating an informative banner, akin to fish_greeting but for Eshell. But an image is worth a thousand words, lets see how it looks like:

Screenshot of the default Eshell information banner (using the nord theme from doom-themes)

This will be displayed every time you open a new Eshell instance, or if you invoke eshell-info-banner from it.

This package is geared towards Linux in particular, I am pretty sure it will not work on Windows, and there will probably be bugs on macOS. PR are welcome if you want to fix that!

Recent Breaking Changes


Version 0.8.1 removes the optional argument REMOTE from eshell-info-banner--executable-find. It now only acts according to the users preference set with eshell-info-banner-tramp-aware.


Version 0.7.0 renames several functions to conform with the Elisp Coding Conventions.

Old Name New Name
eshell-info-banner--ge-mounted-partitions/duf eshell-info-banner--ge-mounted-partitions-duf
eshell-info-banner--get-mounted-partitions/df eshell-info-banner--get-mounted-partitions-df
eshell-info-banner--get-mounted-partitions/windows eshell-info-banner--get-mounted-partitions-windows
eshell-info-banner--get-mounted-partitions/darwin eshell-info-banner--get-mounted-partitions-darwin
eshell-info-banner--get-mounted-partitions/gnu eshell-info-banner--get-mounted-partitions-gnu
eshell-info-banner--get-memory/gnu eshell-info-banner--get-memory-gnu
eshell-info-banner--get-memory/unix eshell-info-banner--get-memory-unix
eshell-info-banner--get-memory/windows eshell-info-banner--get-memory-windows
eshell-info-banner--get-os-information/windows eshell-info-banner--get-os-information-windows
eshell-info-banner--get-os-information/gnu eshell-info-banner--get-os-information-gnu
eshell-info-banner--get-os-information/darwin eshell-info-banner--get-os-information-darwin

The following function was removed:

  • eshell-info-banner--get-memory/darwin

The following alias (replacing an old function) was removed:

  • eshell-info-banner--get-memory/bsd


A couple of options are available for installing eshell-info-banner.el. The first one is to clone the repository in your load-path and add the following to your .emacs or your init.el:

  (require 'eshell-info-banner)
  (add-hook 'eshell-banner-load-hook 'eshell-info-banner-update-banner)

If you use use-package only and install the package from MELPA, you can then install it like so:

  (use-package eshell-info-banner
    :ensure t
    :defer t
    :hook (eshell-banner-load . eshell-info-banner-update-banner))

In my case, I prefer using use-package with straight:

  (use-package eshell-info-banner
    :ensure t
    :defer t
    :straight (:build t)
    :hook (eshell-banner-load . eshell-info-banner-update-banner))

You can just use :straight t if you do not want to ensure the package gets compiled by Emacs.

There is probably a similar way to install it with pure straight.el or quelpa, but Im not knowledgable enough for that, feel free to create a PR to add some more installation instructions!


Custom Variables

A couple of variables can be edited by the user in order to configure eshell-info-banner.el:

Filter for which mountpoints are to be shown to the user. By default, only partitions mounted on a filesystem (as displayed by the command df -Hl) prefixed by /dev are shown, but you can modify it by adding other prefixes to this list. For instance, to detect ZFS roots, you can set its value to ("/dev" "zroot"). Default value: ("/dev")
Try to filter out duplicate partitions. Two partitions are considered duplicate if they have the same size and amount of space used. Default value: nil
List of pattens to exclude from the partition list. Default value: nil
Maximum length of the mount path of a partition before it gets abbreviated. Set it to ridiculous numbers in order to disable it (something like 1000 should be more than enough). Default value: 7
Minimum width of the banner. Be aware the banner will automatically select the minimal width required to display everything it wants to display if eshell-info-banner-width is too small. Default value: 80
Character to fill the progress bar with. Default value: =
Percentage from which the level should be displayed as a warning. Default value: 75
Percentage from which the level should be displayed as critical. Default value: 90
When using Eshell through TRAMP, you can decide whether eshell-info-banner will display information about the remote system you are connected to or only display information about your local system. To achieve this, set eshell-info-banner-tramp-aware to t to display information on the remote system or to nil to keep local information only. Default value: t
Whether or not to use duf. duf is a better replacement for df and should be more platform-agnostic than the latter. I also suspect this implementation will be faster than the one with df, since there is very few string manipulation with duf compared to the implementations with df. Default value: t if duf is found on the system, nil otherwise
Path to your duf executable. If duf is not found by default by Emacs, you can override eshell-info-banner-use-duf with t and specify the path to duf with this custom variable. Default value: duf

This variable reflects the possible values passed to the function file-size-human-readable. It can hold one of these three values:

  • nil
  • si
  • iec

Since the value iec generates longer file size prefixes, progress bars become slightly shorter. For more details on this option, see the documentation of file-size-human-readable.

Default value: nil


Dont like the colors used by the package? They should follow by default your theme, but you can customize the following faces:

Used for filling the empty part of progress bars
Used for filling the progress bar when on normal levels
Used for filling the progress bar when on warning levels
Used for filling the progress bar when on critical levels

My computer doesnt have a battery, will this still work?

As you can see, one line shows you your battery level. Il will start to warn you in a reverse way compared to the other progress bars, as it should for battery levels a fully charged battery at 100% is not at a critical level, but at 0% it would be.

However, you might be on a desktop or any kind of computer that does not have a battery, so… what do? Dont worry, Emacs will automatically detect whether you have a battery or not and will only display this line if you have one. If you dont have a battery, the only difference is you will have one less line than laptop users.

Advice for Windows users

Currently, eshell-info-banner can only look for your partitions with duf. If you want a list of your partitions, I strongly encourage you to install it on your system. See muesli/duf.


eshell-info-banner.el is available under the GNU GPL-3.0 license. You can find the full text in the LICENSE file.