---
name: "dbar"
section: "1"
platform: "linux"
package: "dbar"
version: "0.0.20100524-7"
release: "Debian 13 (Trixie)"
platforms: ["linux"]
url: "https://new.carta.tech/dbar"
---

# dbar(1)

ASCII progresbar

## NAME

dbar - ASCII progresbar

## SYNOPSIS

```
  echo <percentage> | dbar [options] <indicator text>
```

## DESCRIPTION

dbar lets you define static 0% and 100% marks or you can define these marks dynamically at runtime.  Static and dynamic marks can be mixed, in this case the value specified at runtime will have a higher priority.

You can specify ranges of numbers, negative, positive or ranges with a negative min value and positive max value.

All numbers are treated as double precision floating point, i.e. the input is NOT limited to integers.

## OPTIONS

- **-l**

  Label to be prepended to the bar (default: "" ).

- **-nonl**

  no new line, don't put '\\n' at the end of the bar (default: do print "\\n")

- **-max**

  Value to be considered 100% (default: 100).

- **-min**

  Value to be considered 0% (default: 0).

- **-s**

  Symbol represeting the percentage value in the meter (default: "=").

- **-w**

  Number of charcaters to be considered 100% in the meter (default: 25)

## EXAMPLES

Static 100% mark or single value input:

```
    echo 25 | dbar -max 100 -l text
    Output: text  25% [======                   ]
```

If your 100% mark changes dynamically or 2-values input:

```
    echo "50 150" | dbar
          |   |
          |   |__ max value
          |
          |__ value to display
    Output: 33% [========                 ]
```

If your value range is not between \[0, maxval\] or 3-values input:

```
    echo "50 -25 150" | dbar
          |   |  |
          |   |  |__ max value 100% mark
          |   |
          |   |_____ min value 0% mark
          |
          |________ value to display
    Output: 43% [===========              ]
```

Multiple runs:

```
    for i in 2 20 50 75 80; do echo $i; sleep 1; done | dbar | dzen2
    Output: Find out yourself.
```

## ENVIRONMENT

None.

## FILES

None.

## SEE ALSO

[**dzen2**(1)](/dzen2/1.md)

## AUTHORS

Program was written by Robert Manea \<rob.manea@gmail.com\>.

This manual page was written by Jari Aalto \<jari.aalto@cante.net\> for the Debian GNU system (but may be used by others). Released under license GNU GPL version 2 or (at your option) any later version. For more information about license, visit \<http://www.gnu.org/copyleft/gpl.html\>.