# progressbar2

> A Python Progressbar library to provide visual (yet text based) progress to long running operations.

- **URL**: https://www.freshcrate.ai/projects/progressbar2
- **Author**: pypi
- **Category**: Databases
- **Latest version**: `4.5.0` (2026-04-21)
- **License**: BSD-3-Clause
- **Source**: https://github.com/wolph/python-progressbar/issues
- **Homepage**: https://pypi.org/project/progressbar2/
- **Language**: Python
- **GitHub**: 879 stars, 101 forks
- **Registry**: pypi (`progressbar2`)
- **Tags**: `animated`, `bar`, `color`, `console`, `duration`, `efficient`, `elapsed`, `pypi`, `repl`

## Description

##############################################################################
Text progress bar library for Python.
##############################################################################

Build status:

.. image:: https://github.com/WoLpH/python-progressbar/actions/workflows/main.yml/badge.svg
    :alt: python-progressbar test status 
    :target: https://github.com/WoLpH/python-progressbar/actions

Coverage:

.. image:: https://coveralls.io/repos/WoLpH/python-progressbar/badge.svg?branch=master
  :target: https://coveralls.io/r/WoLpH/python-progressbar?branch=master

******************************************************************************
Install
******************************************************************************

The package can be installed through `pip` (this is the recommended method):

    pip install progressbar2

Or if `pip` is not available, `easy_install` should work as well:

    easy_install progressbar2

Or download the latest release from Pypi (https://pypi.python.org/pypi/progressbar2) or Github.

Note that the releases on Pypi are signed with my GPG key (https://pgp.mit.edu/pks/lookup?op=vindex&search=0xE81444E9CE1F695D) and can be checked using GPG:

     gpg --verify progressbar2-<version>.tar.gz.asc progressbar2-<version>.tar.gz

******************************************************************************
Introduction
******************************************************************************

A text progress bar is typically used to display the progress of a long
running operation, providing a visual cue that processing is underway.

The progressbar 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 safely use it as a drop-in replacement for existing project.

The ProgressBar class manages the current progress, and the format of the line
is given by a number of widgets. A widget is an object that may display
differently depending on the state of the progress bar. There are many types
of widgets:

 - `AbsoluteETA <http://progressbar-2.readthedocs.io/en/latest/_modules/progressbar/widgets.html#AbsoluteETA>`_
 - `AdaptiveETA <http://progressbar-2.readthedocs.io/en/latest/_modules/progressbar/widgets.html#AdaptiveETA>`_
 - `AdaptiveTransferSpeed <http://progressbar-2.readthedocs.io/en/latest/_modules/progressbar/widgets.html#AdaptiveTransferSpeed>`_
 - `AnimatedMarker <http://progressbar-2.readthedocs.io/en/latest/_modules/progressbar/widgets.html#AnimatedMarker>`_
 - `Bar <http://progressbar-2.readthedocs.io/en/latest/_modules/progressbar/widgets.html#Bar>`_
 - `BouncingBar <http://progressbar-2.readthedocs.io/en/latest/_modules/progressbar/widgets.html#BouncingBar>`_
 - `Counter <http://progressbar-2.readthedocs.io/en/latest/_modules/progressbar/widgets.html#Counter>`_
 - `CurrentTime <http://progressbar-2.readthedocs.io/en/latest/_modules/progressbar/widgets.html#CurrentTime>`_
 - `DataSize <http://progressbar-2.readthedocs.io/en/latest/_modules/progressbar/widgets.html#DataSize>`_
 - `DynamicMessage <http://progressbar-2.readthedocs.io/en/latest/_modules/progressbar/widgets.html#DynamicMessage>`_
 - `ETA <http://progressbar-2.readthedocs.io/en/latest/_modules/progressbar/widgets.html#ETA>`_
 - `FileTransferSpeed <http://progressbar-2.readthedocs.io/en/latest/_modules/progressbar/widgets.html#FileTransferSpeed>`_
 - `FormatCustomText <http://progressbar-2.readthedocs.io/en/latest/_modules/progressbar/widgets.html#FormatCustomText>`_
 - `FormatLabel <http://progressbar-2.readthedocs.io/en/latest/_modules/progressbar/widgets.html#FormatLabel>`_
 - `FormatLabelBar <http://progressbar-2.readthedocs.io/en/latest/_modules/progressbar/widgets.html#FormatLabel>`_
 - `GranularBar <http://progressbar-2.readthedocs.io/en/latest/_modules/progressbar/widgets.html#GranularBar>`_
 - `Percentage <http://progressbar-2.readthedocs.io/en/latest/_modules/progressbar/widgets.html#Percentage>`_
 - `PercentageLabelBar <http://progressbar-2.readthedocs.io/en/latest/_modules/progressbar/widgets.html#PercentageLabelBar>`_
 - `ReverseBar <http://progressbar-2.readthedocs.io/en/latest/_modules/progressbar/widgets.html#ReverseBar>`_
 - `RotatingMarker <http://progressbar-2.readthedocs.io/en/latest/_modules/progressbar/widgets.html#RotatingMarker>`_
 - `SimpleProgress <http://progressbar-2.readthedocs.io/en/latest/_modules/progressbar/widgets.html#SimpleProgress>`_
 - `Timer <http://progressbar-2.readthedocs.io/en/latest/_modules/progressbar/widgets.html#Timer>`_

The progressbar module is very easy to use, yet very powerful. It will also
automatically enable features like auto-resizing when the system supports it.

******************************************************************************
Known issues
***********

## Recent releases

| Version | Date | Urgency | Changes |
| --- | --- | --- | --- |
| `4.5.0` | 2026-04-21 | Low | Imported from PyPI (4.5.0) |
| `v4.5.0` | 2024-08-28 | Low | Improved build system with many more (and improved) type hints. |
| `v4.5.0` | 2024-08-28 | Low | Improved build system with many more (and improved) type hints. |
| `v4.5.0` | 2024-08-28 | Low | Improved build system with many more (and improved) type hints. |
| `v4.5.0` | 2024-08-28 | Low | Improved build system with many more (and improved) type hints. |
| `v4.5.0` | 2024-08-28 | Low | Improved build system with many more (and improved) type hints. |
| `v4.5.0` | 2024-08-28 | Low | Improved build system with many more (and improved) type hints. |
| `v4.5.0` | 2024-08-28 | Low | Improved build system with many more (and improved) type hints. |
| `v4.5.0` | 2024-08-28 | Low | Improved build system with many more (and improved) type hints. |
| `v4.5.0` | 2024-08-28 | Low | Improved build system with many more (and improved) type hints. |

## Citation

- HTML: https://www.freshcrate.ai/projects/progressbar2
- Markdown: https://www.freshcrate.ai/projects/progressbar2.md
- Dependencies JSON: https://www.freshcrate.ai/api/projects/progressbar2/deps

_Generated by freshcrate.ai. Indexes pypi releases for AI-agent ecosystem packages._