DSTAT(1)

NAME
dstat - dwm status bar statistics

SYNOPSIS
dstat if
dstat version

DESCRIPTION
dstat is a lightweight utility to set the dwm(1) status bar text. dstat displays the current network throughput for the given interface if, wireless signal quality, CPU usage, performance settings, power/battery status, temperature, volume settings, as well as the current date and time on the dwm(1) status bar.

The arguments are as follows:

if  Specify the interface to collect the network statistics.

version
    Print the version and copyright information of dstat to the standard output, then exit.

dstat is supposed to be started with the dwm(1) session. dstat updates the statistics shown on the dwm(1) status bar every second using the results from ioctl(2), calls as well as calls to apm(4), getifaddrs(3), sndio(7), sysctl(2), and time(3). If a battery is available, dstat displays a warning window if the estimated number of minutes for the remaining battery life drops below 10 minutes.

EXIT STATUS

EXAMPLES
Run dstat using the urtwn0 network interface:

    $ dstat urtwn0 &

Print version and copyright information of dstat to the standard output stream and exit successfully:

    $ dstat version

  Integrations
Pipe dstat output to dzen2:

    $ dstat urtwn0 | dzen2 -fn "-*-terminus-medium-*-*-*-*-*-*-*-*-*-*-*"

Use dstat output in i3(1) via i3bar(1) by adding the the following lines to the configuration:

    bar {
        status_command dstat trunk0
    }

Pipe dstat output to lemonbar(1):

    $ dstat urtwn0 | lemonbar -d -f "-*-terminus-medium-*-*-*-*-*-*-*-*-*-*-*"

Use dstat output in right status bar of tmux(1) by adding the following configuration commands:

    set -g status-right-length 100
    set -g status-right '#(dstat trunk0)'

Pipe dstat output to xmobar:

    $ dstat urtwn0 | \
    > xmobar -b -f "-*-terminus-medium-*-*-*-*-*-*-*-*-*-*-*" \
    > -t "%StdinReader%" -c "[Run StdinReader]"

dstat can also be used with tint2(1) by adding an executor to the panel items within the configuration, like in the following:

    execp = new
    execp_command = /usr/local/bin/dstat trunk0
    execp_interval = 0
    execp_continuous = 1
    panel_items = TE

SEE ALSO
dwm(1), ioctl(2), sysctl(2), getifaddrs(3), time(3), apm(4), sndio(7)

STANDARDS
The dstat utility is not compliant with any specification.

Where portability is paramount, do not use it.

HISTORY
The first version of the dstat utility was a shell script and appeared back in May 2013.

AUTHORS
-nosplit dstat was written by Joerg Jung <mail@umaxx.net>.

CAVEATS
Displayed wireless signal quality is rather coarse grained.

HOMEPAGE
https://www.umaxx.net/