.TH MPB 1 2020-04-02
.SH NAME
mpb \- more progress bar
.SH SYNOPSIS
.B mpb
[\fB\-o\fR] [\fB\-v\fR] [\fB\-s\fR] [\fB\-w\fR\fIWIDTH\fR] [\fITOTAL\fR]
.SH DESCRIPTION
Show progress of lines read from \fIstdin\fR in \fIstderr\fR.
.SH OPTIONS
.TP
\fB\-o\fR
output \fIstdin\fR to \fIstdout\fR
.TP
\fB\-v\fR
show current line
.TP
\fB\-s\fR
show activity spinner
.TP
\fB\-w\fR\fIWIDTH\fR
set width of progress bar (default = 32)
.TP
\fITOTAL\fR
number of lines expected to be read until completion of task
.br
if \fITOTAL\fR is not given or it is zero, the progress bar will not be shown
.SH EXAMPLES
Use \fBseq(1)\fR to test drive \fBmpb\fR:
.RS
.nf
$ n=5000; seq $n | mpb -vsw50 $n
.fi
.RE
.PP
Show path of file currently being extracted by \fBtar(1)\fR (without progress bar):
.RS
.nf
$ tar vxf foo.tgz | mpb -v
.fi
.RE
.PP
Pre-compute the number of files in archive to add extraction progress bar:
.RS
.nf
$ f=foo.tgz; n=$(tar tf $f | wc -l); tar vxf $f | mpb -v $n
.fi
.RE