Dool

🔍 What is Dool?

Dool is a command line tool to monitor many aspects of your Linux system: CPU,
Memory, Network, Load Average, etc. It also includes a robust plug-in
architecture to allow monitoring other system metrics.

Dool is a Python3 compatible fork of Dstat.

📦 Installation

1. Download the latest release
   archive file or clone the Git repo
2. Copy dool into your $PATH
3. Copy plugins/* to ~/.dool/ (optional)

✨ Usage

dool [--preset] [--plugin] [delay]

My most common usage of Dool is:

dool --more 15

which uses the --more preset and outputs data every 15 seconds. Available
presets are --defaults, --more, or --all. If no delay is specified,
Dool will default to outputting every second.

🖼️ Screenshots

Dark mode (default)

Light mode

🔌 Plugins:

Dool ships with many plug-ins to configure the output to your taste.

dool --cpu --net --time --full # Show CPU usage, and each network interface
dool --disk -D total,sda,sdd   # Show the total disk IO, and /dev/sda and /dev/sdd
dool --net -N eth0,eth1        # Show the network traffic for eth0 and eth1

A list of available plug-ins are available when you run dool --version

🎨 Colors

Dool expects a 256 color compatible terminal. Most modern terminal emulators
support this automatically. A --color16 option is available if you only have
a 16 color terminal.

📈 Bits vs Bytes

One of the changes in dool is measurement of network and disk bandwidth in
bits instead of bytes. This can be confusing if you're used to seeing
lower numbers in dstat. If you would rather see bandwidth reported in bytes
you can use the --bytes option.

🧰 Other tools similar to Dool

• htop
• btop
• iotop

🎁 Packaging Dool for your distro

If you want to build a Dool package for your favorite distribution check out
our simple instructions. Currently we have scripts
to build rpm, deb, and .tar.gz packages.

🌿 Pull Requests and Branches

The latest stable release (plus bugfixes) will live on the master branch.
Development of new features will occur on the next branch. Please have
pull requests target the next branch.

Various feature/bug branches may come and go as we work on more complex
functionality, but those can be safely ignored.

Do you want to write your own plugin? Check out the
skel plugin which should be well documented and
serve as a good starting point.

👨 Team

Username	Role
@scottchiefbaker	Primary author
@dagwieers	Original dstat author
@raylu	Pip release manager