Skip to main content

Dool is a command line tool to monitor many aspects of your system: CPU,

Project description

🔍 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) Dool Light

Light mode Dool Light

🔌 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:

🌿 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

Project details


Download files

Download the file for your platform. If you're not sure which to choose, learn more about installing packages.

Source Distribution

dool-1.3.8.tar.gz (83.5 kB view details)

Uploaded Source

Built Distribution

If you're not sure about the file name format, learn more about wheel file names.

dool-1.3.8-py3-none-any.whl (136.8 kB view details)

Uploaded Python 3

File details

Details for the file dool-1.3.8.tar.gz.

File metadata

  • Download URL: dool-1.3.8.tar.gz
  • Upload date:
  • Size: 83.5 kB
  • Tags: Source
  • Uploaded using Trusted Publishing? Yes
  • Uploaded via: twine/6.1.0 CPython/3.13.7

File hashes

Hashes for dool-1.3.8.tar.gz
Algorithm Hash digest
SHA256 36d3ddb6022697c4fa78320dc5fbd139da7e6e63c550c1dd7b992914348218c6
MD5 e2ec179c8a7b9006d876b9bae1e4944e
BLAKE2b-256 3c274216346e7cee341b0697a6f9d8408ccce05b27d6c87dd735a3700bafbc9f

See more details on using hashes here.

Provenance

The following attestation bundles were made for dool-1.3.8.tar.gz:

Publisher: pypi.yaml on scottchiefbaker/dool

Attestations: Values shown here reflect the state when the release was signed and may no longer be current.

File details

Details for the file dool-1.3.8-py3-none-any.whl.

File metadata

  • Download URL: dool-1.3.8-py3-none-any.whl
  • Upload date:
  • Size: 136.8 kB
  • Tags: Python 3
  • Uploaded using Trusted Publishing? Yes
  • Uploaded via: twine/6.1.0 CPython/3.13.7

File hashes

Hashes for dool-1.3.8-py3-none-any.whl
Algorithm Hash digest
SHA256 468a1ceea156820c3a929daa8d2b98296dcc78dfd619fd57633d1cf887fddb73
MD5 2a634ac5dce7fdaa0f1829c40e05dfba
BLAKE2b-256 02cf975b0e133bd3fe751f959f7ed3d70b98f86dfc314a54d05a3c8644babe6f

See more details on using hashes here.

Provenance

The following attestation bundles were made for dool-1.3.8-py3-none-any.whl:

Publisher: pypi.yaml on scottchiefbaker/dool

Attestations: Values shown here reflect the state when the release was signed and may no longer be current.

Supported by

AWS Cloud computing and Security Sponsor Datadog Monitoring Depot Continuous Integration Fastly CDN Google Download Analytics Pingdom Monitoring Sentry Error logging StatusPage Status page