Quick search

Table Of Contents

Progress Bar

New in version 1.0.8.


The ProgressBar widget is used to visualize the progress of some task. Only the horizontal mode is currently supported: the vertical mode is not yet available.

The progress bar has no interactive elements and is a display-only widget.

To use it, simply assign a value to indicate the current progress:

from kivy.uix.progressbar import ProgressBar
pb = ProgressBar(max=1000)

# this will update the graphics automatically (75% done)
pb.value = 750
class kivy.uix.progressbar.ProgressBar(**kwargs)[source]

Bases: kivy.uix.widget.Widget

Class for creating a progress bar widget.

See module documentation for more details.


Maximum value allowed for value.

max is a NumericProperty and defaults to 100.


Current value used for the slider.

value is an AliasProperty that returns the value of the progress bar. If the value is < 0 or > max, it will be normalized to those boundaries.

Changed in version 1.6.0: The value is now limited to between 0 and max.


Normalized value inside the range 0-1:

>>> pb = ProgressBar(value=50, max=100)
>>> pb.value
>>> pb.value_normalized

value_normalized is an AliasProperty.