An android library to display a progressbar that goes around an image.
Clone or download

android-square-progressbar Download

square image

First things first

This library is setup to work with the Android Studio and Gradle. If you're using the Eclipse environment then check out the legacy repository here: android-square-progressbar-legacy.

You can find my blog post about the newest version here: - android-square-progressbar v.1.6.0, also check out the post about the previous major 1.5.0 version here.

The example application is available at the play store:

Get it on Google Play

Join the chat at

General idea

Sometimes you don't have enough space in your layout to display a wide progressbar. So this library gives you a complete new possibility to display a progress. You can simply show a progressbar around an image. And this progressbar can be configured in a lot of different ways, like colour, outline, display of the percentage and so on.


Here are some examples of how these progressbars could look like:

normal / default rounded corners show percent indeterminate
setRoundedCorners(true) showProgress(true) drawOutline(true)
setOpacity(true) setIndeterminate(true)

There are some further examples available here (with code) : Examples

How to use it? / How to install? / How to contribute?

Check the wiki for more information about how to use, how to install or how to contribute.

If you have questions about the code or if you need some help, you can try the Gitter-Group.



This library now works with gradle and will soon be available on the central maven repository. For the moment its on jCenter at Bintray. Just add the following repository to your root build.gradle:

allprojects {
    repositories {
        maven { url "" }

Then in your app build.gradle:

dependencies {
    // other repos ...
    implementation 'ch.halcyon:squareprogressbar:1.6.4'


After adding the gradle depedency from above you can go to your xml layout and add the following code for a squareprogressbar:

    android:paddingTop="20dp" >

To set some basic settings use the following java-code:

SquareProgressBar squareProgressBar = findViewById(;

Now you can make the squareprogressbar as fancy as you like. Check the usage page for all the different possiblities.