Skip to content
<awesome-gh-repos>
vic

jfelchner/ruby-progressbar

Ruby/ProgressBar is a text progress bar library for Ruby.
Source code at GitHub https://github.com/jfelchner/ruby-progressbar
jfelchner/ruby-progressbar.json
{
  "createdAt": "2009-02-16T22:06:07Z",
  "defaultBranch": "master",
  "description": "Ruby/ProgressBar is a text progress bar library for Ruby.",
  "fullName": "jfelchner/ruby-progressbar",
  "homepage": "",
  "language": "Ruby",
  "name": "ruby-progressbar",
  "pushedAt": "2024-06-12T04:34:26Z",
  "stargazersCount": 1584,
  "topics": [
    "cli",
    "progress",
    "progress-bar",
    "progressbar",
    "progressbars",
    "terminal"
  ],
  "updatedAt": "2025-11-25T19:18:09Z",
  "url": "https://github.com/jfelchner/ruby-progressbar"
}

Ruby/ProgressBar

Section titled “Ruby/ProgressBar”

The ultimate text progress bar library for Ruby! It’ll SMASH YOU OVER THE HEAD with a PURE RUSH of progress bar excitement!

Don’t miss out on what all the kids are talking about! If you want everyone to know that your gem or app can survive in the cage then YOU WANT RUBY-PROGRESSBAR!


It’s Better Than The Other 186,312 Progress Bar Libraries Because

Section titled “It’s Better Than The Other 186,312 Progress Bar Libraries Because”

  • It has [stood the test of time][history] (2008-today)

  • Full test suite

  • [ZERO dependencies][gemspec]

  • Used by [tons of other open source projects][dependencies] (which means we find out about bugs quickly)

  • It’s pretty freakin’ sweet

  • And most importantly… our awesome [contributors][contributors]

Basic Usage

Section titled “Basic Usage”

Creation

Section titled “Creation”

It’s simple to get started:

progressbar = ProgressBar.create

Creates a basic progress bar beginning at 0, a maximum capacity of 100 and tells it to start.

Progress: |                                                                       |

Marking Progress

Section titled “Marking Progress”

Every call to #increment will advance the bar by 1. Therefore:

50.times { progressbar.increment }

Would output an advancing line which would end up here:

Progress: |===================================                                    |

Animation

Section titled “Animation”

Basic Usage Marking Progress

Full Reference

Section titled “Full Reference”

There’s gotten to be too much awesome to pack into one page. Visit the [wiki][wiki] for the full documentation.

Issues

Section titled “Issues”

If you have problems, please create a [Github issue][issues].

Credits

Section titled “Credits”

![The Kompanee][kompanee-logo]

ruby-progressbar is maintained by [The Kompanee, Ltd.][kompanee-site]

The names and logos for The Kompanee are trademarks of The Kompanee, Ltd.

License

Section titled “License”

ruby-progressbar 1.0 is Copyright © 2011-2021 The Kompanee. It is free software, and may be redistributed under the terms specified in the LICENSE file. ruby-progressbar 0.9.0 is Copyright © 2008 [Satoru Takabayashi][satoru]

[contributors] !: https://github.com/jfelchner/ruby-progressbar/graphs/contributors [dependencies] !: https://github.com/jfelchner/ruby-progressbar/network/dependents [gemspec] !: https://github.com/jfelchner/ruby-progressbar/blob/master/ruby-progressbar.gemspec [history] !: https://github.com/jfelchner/ruby-progressbar/wiki/History [issues] !: https://github.com/jfelchner/ruby-progressbar/issues [kompanee-logo] !: https://kompanee-public-assets.s3.amazonaws.com/readmes/kompanee-horizontal-black.png [kompanee-site] !: http://www.thekompanee.com [satoru] !: http://0xcc.net [wiki] !: https://github.com/jfelchner/ruby-progressbar/wiki