A typed terminal progress bar library for Python. It handles custom widgets, clean output around prints and logs, multiple concurrent bars, unknown-length progress, and pipe-friendly CLI usage.

python-progressbar test status coverage status

Install

pip install progressbar2

Quick start

import time
import progressbar

for item in progressbar.progressbar(range(100), desc='Loading'):
    time.sleep(0.02)

Try it in your browser

Every example in the documentation runs live in the page. Press Run on any code block, no install required.

Progress with clean logs

progressbar2 showing clean progress output with logs 
"""A build log printing above a progress bar without corrupting it."""

from __future__ import annotations

import time

import progressbar

STEPS = 24


def main() -> None:
    with progressbar.ProgressBar(
        max_value=STEPS,
        prefix='Build ',
        redirect_stdout=True,
    ) as bar:
        for step in range(STEPS):
            if step in {8, 16}:
                print(f'log: completed step {step}')
            bar.update(step + 1)
            # Longer than the bar's 0.05s update gate, so every step
            # lands as a visible redraw.
            time.sleep(0.1)


if __name__ == '__main__':
    main()

Multiple bars

multiple progress bars updating together 
"""Two named bars progressing at different rates in one terminal."""

from __future__ import annotations

import sys
import time

import progressbar

STEPS = 24


def main() -> None:
    with progressbar.MultiBar(fd=sys.stdout) as multibar:
        build = multibar['build']
        test = multibar['test']
        build.max_value = STEPS
        test.max_value = STEPS
        for step in range(STEPS):
            build.update(step + 1)
            test.update(min(STEPS, max(0, round((step - 3) * 1.2))))
            # Longer than the bars' 0.05s update gate, so every step
            # lands as a visible redraw.
            time.sleep(0.1)

        # Reaching max_value doesn't finish a bar -- only finish() does.
        # A MultiBar waits for every bar to report finished() before its
        # context manager can exit, so without these calls the block
        # above would hang forever on exit.
        build.finish()
        test.finish()


if __name__ == '__main__':
    main()

Unknown length and animated bars

unknown length progress with an animated marker 
"""A bar for work whose total is not known up front."""

from __future__ import annotations

import time

import progressbar


def main() -> None:
    with progressbar.ProgressBar(
        max_value=progressbar.UnknownLength,
    ) as bar:
        for value in range(0, 120, 10):
            bar.update(value)
            # Longer than the bar's 0.05s update gate, so every step
            # lands as a visible redraw.
            time.sleep(0.1)


if __name__ == '__main__':
    main()

CLI usage

progressbar --progress --timer --eta --rate --bytes input.bin -o output.bin

Known terminal caveats

  • JetBrains IDEs need “Enable terminal in output console” for advanced terminal behavior such as MultiBar.

  • IDLE does not support terminal progress bars.

  • Jupyter buffers stdout; call sys.stdout.flush() when output appears late.

Project history

progressbar2 is based on the old Python progressbar package that was published on the now defunct Google Code. Since that project was completely abandoned by its developer and the developer did not respond to email, I decided to fork the package.

This package is still backwards compatible with the original progressbar package so you can use it as a drop-in replacement for existing projects.

Links

Project links

Data verified by PyPI on Aug 14, 2026
Data provided by the project maintainers, verified at the time the release was uploaded to PyPI.

Key dates

PyPI data
Data sourced directly from PyPI's database.
  • Released:
Latest release

2 maintainers

PyPI data
Data sourced directly from PyPI's database.
Avatar for jhammudoglu from gravatar.com jhammudoglu Avatar for wolph from gravatar.com wolph

Credits

Author: Rick van Hattem (Wolph)

GitHub Statistics

Data verified by PyPI on Aug 14, 2026
The GitHub source repository was provided by the project maintainers and verified by PyPI at the time of upload. Stars, forks, and open issues/PRs are derived from that repository and have not been independently verified.

License

BSD License (BSD-3-Clause)

Requires

Python >=3.10

Provides Extra

fast docs tests docs-tests

Tags

REPL animated bar color console duration efficient elapsed eta feedback live meter monitor monitoring multi-threaded progress progress-bar progressbar progressmeter python rate simple speed spinner stats terminal throughput time visual

Classifiers

Report project as malware

Download files

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

Source Distribution

progressbar2-4.6.0.tar.gz (542.5 kB view details)

Uploaded Source

Built Distribution

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

progressbar2-4.6.0-py3-none-any.whl (104.2 kB view details)

Uploaded Python 3

File details

Details for the file progressbar2-4.6.0.tar.gz.

File metadata

  • Download URL: progressbar2-4.6.0.tar.gz
  • Upload date:
  • Size: 542.5 kB
  • Tags: Source
  • Uploaded using Trusted Publishing? Yes
  • Uploaded via: twine/7.0.0 CPython/3.13.14

File hashes

Hashes for progressbar2-4.6.0.tar.gz
Algorithm Hash digest
SHA256 fe48c8955a84428af77bff2642ba47041e1b8f7c867a5b7cc94f8bc255a8f0cf
MD5 28fb3387120a80ce8f18f762ae10b21b
BLAKE2b-256 0c1e5bd376abe32a392e74fffd82feb42ee1472d263bd358d628af20663d0346

See more details on using hashes here.

Provenance

The following attestation bundles were made for progressbar2-4.6.0.tar.gz:

Publisher: release.yml on wolph/python-progressbar

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

File details

Details for the file progressbar2-4.6.0-py3-none-any.whl.

File metadata

  • Download URL: progressbar2-4.6.0-py3-none-any.whl
  • Upload date:
  • Size: 104.2 kB
  • Tags: Python 3
  • Uploaded using Trusted Publishing? Yes
  • Uploaded via: twine/7.0.0 CPython/3.13.14

File hashes

Hashes for progressbar2-4.6.0-py3-none-any.whl
Algorithm Hash digest
SHA256 2d78bdeb1debef92a39dd9042e0689542bd72d6e2f30b13432db371aa9d8ee4e
MD5 d3ef2a6882daa8a19159982f85478377
BLAKE2b-256 704cba64c450164fa4feaa9c4bb1c6445811d89d6a1995bfc58d039273b698af

See more details on using hashes here.

Provenance

The following attestation bundles were made for progressbar2-4.6.0-py3-none-any.whl:

Publisher: release.yml on wolph/python-progressbar

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

Release history Release notifications | RSS feed

This release

4.6.0

4.5.0

4.4.3 yanked

Reason this release was yanked:

SyntaxError: invalid syntax

4.4.2

4.4.1

4.4.0

4.3.2

4.3.1

4.3.0

4.3b0 pre-release

4.2.0

4.1.1

4.1.0

4.0.0

3.55.0

3.54.0

3.53.3

3.53.2

3.53.1

3.53.0

3.52.1

3.51.4

3.51.3

3.51.2

3.51.1

3.51.0

3.50.1

3.50.0

3.47.0

3.46.1

3.46.0

3.45.1

3.43.1

3.42.0

3.41.0

3.39.3

3.39.2

3.39.0

3.38.0

3.37.1

3.37.0

3.36.0

3.35.2

3.35.1

3.35.0

3.34.3

3.34.2

3.34.0

3.33.2

3.33.1

3.33.0

3.32.1

3.32.0

3.31.1

3.30.2

3.30.0

3.20.2

3.20.1

3.20.0

3.18.1

3.18.0

3.17.1

3.17.0

3.16.1

3.16.0

3.15.1

3.15.0

3.12.0

3.11.0

3.10.1

3.10.0

3.9.4

3.9.3

3.9.2

3.9.1

3.9.0

3.8.1

3.8.0

3.7.0

3.6.2

3.6.1

3.6.0

3.5.2

3.5.1

3.5.0

3.4.3

3.4.2

3.4.1

3.4.0

3.3.3

3.3.2

3.3.1

3.3.0

3.2.0

3.1.0

3.0.1

2.7.3

2.7.0

2.6.9

2.6.8

2.6.7

2.6.6

2.6.5

2.6.4

2.6.3

2.6.2

2.6.1

2.6.0

2.5.0

2.4.1

2.4.0

Supported by

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