{"id":13606396,"url":"https://github.com/MackHartley/RoundedProgressBar","last_synced_at":"2025-04-12T08:31:05.799Z","repository":{"id":37299940,"uuid":"291368256","full_name":"MackHartley/RoundedProgressBar","owner":"MackHartley","description":"A customizable, animated progress bar that features rounded corners. This Android library is designed to look great and be simple to use 🎉","archived":false,"fork":false,"pushed_at":"2024-01-28T23:55:41.000Z","size":17899,"stargazers_count":784,"open_issues_count":0,"forks_count":60,"subscribers_count":7,"default_branch":"master","last_synced_at":"2024-11-07T11:44:10.899Z","etag":null,"topics":["android","android-library","animated","progress-bar","rounded-corners"],"latest_commit_sha":null,"homepage":"","language":"Kotlin","has_issues":true,"has_wiki":null,"has_pages":null,"mirror_url":null,"source_name":null,"license":"apache-2.0","status":null,"scm":"git","pull_requests_enabled":true,"icon_url":"https://github.com/MackHartley.png","metadata":{"files":{"readme":"README.md","changelog":null,"contributing":"CONTRIBUTING.md","funding":null,"license":"LICENSE","code_of_conduct":"CODE_OF_CONDUCT.md","threat_model":null,"audit":null,"citation":null,"codeowners":null,"security":null,"support":null,"governance":null,"roadmap":null,"authors":null,"dei":null,"publiccode":null,"codemeta":null}},"created_at":"2020-08-29T23:56:20.000Z","updated_at":"2024-11-07T05:31:53.000Z","dependencies_parsed_at":"2024-08-01T19:53:29.291Z","dependency_job_id":null,"html_url":"https://github.com/MackHartley/RoundedProgressBar","commit_stats":null,"previous_names":[],"tags_count":7,"template":false,"template_full_name":null,"repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/MackHartley%2FRoundedProgressBar","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/MackHartley%2FRoundedProgressBar/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/MackHartley%2FRoundedProgressBar/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/MackHartley%2FRoundedProgressBar/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/MackHartley","download_url":"https://codeload.github.com/MackHartley/RoundedProgressBar/tar.gz/refs/heads/master","host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":248539799,"owners_count":21121234,"icon_url":"https://github.com/github.png","version":null,"created_at":"2022-05-30T11:31:42.601Z","updated_at":"2022-07-04T15:15:14.044Z","host_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub","repositories_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories","repository_names_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repository_names","owners_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners"}},"keywords":["android","android-library","animated","progress-bar","rounded-corners"],"created_at":"2024-08-01T19:01:08.776Z","updated_at":"2025-04-12T08:31:00.786Z","avatar_url":"https://github.com/MackHartley.png","language":"Kotlin","funding_links":[],"categories":["Kotlin","Index"],"sub_categories":[],"readme":"\u003cp align=\"center\"\u003e\n    \u003cimg src=\"https://user-images.githubusercontent.com/10659285/113659138-06835400-9667-11eb-8f8b-5d8da5eba1c8.gif\" /\u003e\n\u003c/p\u003e\n\u003ch1 align=\"center\"\u003eRoundedProgressBar\u003c/h1\u003e\n\u003cp align=\"center\"\u003eEasy, Beautiful, Customizable\u003c/p\u003e\n\n\u003cp align=\"center\"\u003e\n    \u003ca href=\"https://android-arsenal.com/api?level=21\"\u003e\u003cimg src=\"https://img.shields.io/badge/API-21%2B-blue.svg?style=flat\" height=\"20\"/\u003e\u003c/a\u003e\n    \u003ca href=\"https://github.com/MackHartley/RoundedProgressBar/actions/workflows/buildAndTest.yml\"\u003e\u003cimg src=\"https://github.com/MackHartley/RoundedProgressBar/actions/workflows/buildAndTest.yml/badge.svg\" /\u003e\u003c/a\u003e\n    \u003ca href=\"https://ktlint.github.io/\"\u003e\u003cimg src=\"https://img.shields.io/badge/code%20style-%E2%9D%A4-FF4081.svg\" alt=\"ktlint\"\u003e\u003c/a\u003e\n    \u003ca href=\"https://androidweekly.net/issues/issue-467\"\u003e\u003cimg alt=\"Android Weekly\" src=\"https://img.shields.io/badge/Android%20Weekly-%23467-orange\"/\u003e\u003c/a\u003e\n    \u003ca href=\"https://medium.com/@mmbialas/25-best-android-libraries-projects-and-tools-you-dont-want-to-miss-in-2021-681dafe58b1c\"\u003e\u003cimg alt=\"Medium\" src=\"https://badges.aleen42.com/src/medium.svg\"/\u003e\u003c/a\u003e\n\u003c/p\u003e\n\nUsing the `RoundedProgressBar` library you can easily create beautiful progress bars with individually rounded corners, animating progress text and more! Below are several examples of progress bars created with this library.\n\u003cbr\u003e\n\u003cbr\u003e\n\u003cp align=\"center\"\u003e\n    \u003cimg src=\"https://user-images.githubusercontent.com/10659285/157208030-fe44f49d-1a86-4dec-bb07-a2eb28a60531.gif\" width=\"400\"/\u003e\n\u003c/p\u003e\n\nIf you’d like to see if this library is right for your project then try downloading the demo app which is available on the [Google Play Store](https://play.google.com/store/apps/details?id=com.mackhartley.roundedprogressbarexample). There you can fully customize a `RoundedProgressBar` to see if you’re able to achieve the desired look and feel for your project.\n\u003cbr\u003e\n\u003cp align=\"center\"\u003e\n    \u003ca href='https://play.google.com/store/apps/details?id=com.mackhartley.roundedprogressbarexample\u0026pcampaignid=pcampaignidMKT-Other-global-all-co-prtnr-py-PartBadge-Mar2515-1'\u003e\u003cimg alt='Get it on Google Play' src='https://play.google.com/intl/en_us/badges/static/images/badges/en_badge_web_generic.png' height=\"100\"/\u003e\u003c/a\u003e\n    \u003cbr\u003e\n    \u003cimg src=\"https://user-images.githubusercontent.com/10659285/113660889-a7274300-966a-11eb-8185-a992f485bd79.gif\" width=\"400\"/\u003e\n\u003c/p\u003e\n\nDo you use `RoundedProgressBar` in your app? Consider adding a picture or GIF of your usage to [`who_uses_rpb.md`](https://github.com/MackHartley/RoundedProgressBar/blob/master/who_uses_rpb.md). This provides examples to developers on how the library is used and gives your app a bit of **free publicity!**\n\n# Gradle Setup ⚙️\n[![](https://jitpack.io/v/MackHartley/RoundedProgressBar.svg)](https://jitpack.io/#MackHartley/RoundedProgressBar)\n\nIf you don't have this already, add it to your **root** build.gradle file:\n```\nallprojects {\n    repositories {\n        ...\n        maven { url 'https://jitpack.io' }\n    }\n}\n```\n\nThen you can add the dependency to your **app** build.gradle file:\n```\ndependencies {\n    ...\n    implementation 'com.github.MackHartley:RoundedProgressBar:3.0.0'\n}\n```\n\n# Notable Features 🌟\n\n1) **Full Color Customization** - You can even specify what color the text is depending on which background it draws over. Transparent colors are also supported\n\u003cp align=\"center\"\u003e\n    \u003cimg src=\"https://user-images.githubusercontent.com/10659285/113535487-2cdabe00-9599-11eb-823f-a5256432b575.gif\" /\u003e\n    \u003cbr\u003e\n    \u003ca href=\"exampleXmlLayouts/feature2.xml\"\u003eClick here to see code\u003c/a\u003e\n\u003c/p\u003e\n\n2) **Complete Text Customization** - The text displayed on the progress bar can be \u003ca href=\"https://github.com/MackHartley/RoundedProgressBar/blob/master/roundedprogressbar/src/main/java/com/mackhartley/roundedprogressbar/ProgressTextFormatter.kt#L3\"\u003ecustomized\u003c/a\u003e to say whatever you want. Additionally you can add padding and even supply your own font for use with the progress bar (`.ttf` and `.otf` formats supported)\n\u003cp align=\"center\"\u003e\n    \u003cimg src=\"https://user-images.githubusercontent.com/10659285/115816354-592a7300-a3be-11eb-88e4-c975bb4028e3.gif\" /\u003e\n    \u003cbr\u003e\n    \u003ca href=\"https://github.com/MackHartley/RoundedProgressBar/blob/master/app/src/main/res/layout/activity_main.xml#L426-L439\"\u003eClick here to see code\u003c/a\u003e\n\u003c/p\u003e\n\n3) **Low Value Support** - The progress bar looks nice even at low values (This is a common issue when dealing with rounded progress bars)\n\u003cp align=\"center\"\u003e\n    \u003cimg src=\"https://user-images.githubusercontent.com/10659285/113535772-f8b3cd00-9599-11eb-8b1a-ee6ec9e323c2.gif\" /\u003e\n    \u003cbr\u003e\n    \u003ca href=\"exampleXmlLayouts/feature3.xml\"\u003eClick here to see code\u003c/a\u003e\n\u003c/p\u003e\n\n4) **Any Corner Radius Allowed** - Individual corners can even have different radius values\n\u003cp align=\"center\"\u003e\n    \u003cimg src=\"https://user-images.githubusercontent.com/10659285/113536397-a83d6f00-959b-11eb-9328-84dcab86ff04.gif\" /\u003e\n    \u003cbr\u003e\n    \u003ca href=\"exampleXmlLayouts/feature4.xml\"\u003eClick here to see code\u003c/a\u003e\n\u003c/p\u003e\n\n5) **Modular** - The `RoundedProgressBar` library can be seamlessly included in custom layouts due to the fact that each corner can have a different radius\n\u003cp align=\"center\"\u003e\n    \u003cimg src=\"https://user-images.githubusercontent.com/10659285/115661295-d7294400-a302-11eb-8739-b68907e2ecd4.gif\" /\u003e\n    \u003cbr\u003e\n    Click \u003ca href=\"https://github.com/MackHartley/RoundedProgressBar/blob/gif-creation-version/app/src/main/res/layout/activity_main.xml#L698-L738\"\u003ehere\u003c/a\u003e or \u003ca href=\"exampleXmlLayouts/feature5.xml\"\u003ehere\u003c/a\u003e to see code\n\u003c/p\u003e\n    \n**Additionally**, the `RoundedProgressBar` handles all internal state during configuration changes\n\n# Public Methods and Xml Attributes 💻\nThese are the methods which can be called on the `RoundedProgressBar` class:\n\n```\nsetProgressPercentage(progressPercentage: Double, shouldAnimate: Boolean = true)\ngetProgressPercentage(): Double\n\nsetProgressDrawableColor(@ColorInt newColor: Int) // Sets the color of the 'progress' part of the progress bar\nsetBackgroundDrawableColor(@ColorInt newColor: Int) // Sets the color of the 'background' part of the progress bar\nsetProgressTextColor(@ColorInt newColor: Int) // Sets text color for when it is drawn over the progress part of progress bar\nsetBackgroundTextColor(@ColorInt newColor: Int) // Sets text color for when it is drawn over the background part of progress bar\n\nsetCornerRadius(\n    topLeftRadius: Float,\n    topRightRadius: Float,\n    bottomRightRadius: Float,\n    bottomLeftRadius: Float\n)\n\nsetTextSize(newTextSize: Float)\nsetTextPadding(newTextPadding: Float) // Sets the padding between the progress text and end (or start) of the progress bar\nsetAnimationLength(newAnimationLength: Long)\n\nshowProgressText(shouldShowProgressText: Boolean)\nsetRadiusRestricted(isRestricted: Boolean)\n```\n\nThe `RoundedProgressBar` can also be configured via xml attributes. Below is the full list of attributes along with the methods they map to.\n| Xml Attribute | Method |\n|---|---|\n| `rpbProgress` | `setProgressPercentage(...)` |\n| `rpbProgressColor` | `setProgressDrawableColor(...)` |\n| `rpbBackgroundColor` | `setBackgroundDrawableColor(...)` |\n| `rpbProgressTextColor` | `setProgressTextColor(...)` |\n| `rpbBackgroundTextColor` | `setBackgroundTextColor(...)` |\n| `rpbCornerRadius` | `setCornerRadius(...)` |\n| `rpbCornerRadiusTopLeft` | `setCornerRadius(...)` |\n| `rpbCornerRadiusTopRight` | `setCornerRadius(...)` |\n| `rpbCornerRadiusBottomRight` | `setCornerRadius(...)` |\n| `rpbCornerRadiusBottomLeft` | `setCornerRadius(...)` |\n| `rpbTextSize` | `setTextSize(...)` |\n| `rpbTextPadding` | `setTextPadding(...)` |\n| `rpbAnimationLength` | `setAnimationLength(...)` |\n| `rpbShowProgressText` | `showProgressText(...)` |\n| `rpbIsRadiusRestricted` | `setRadiusRestricted(...)` |\n\n# Contributing 🤝\nFeel free to open up issues on this repo to report bugs or request features. \n\nAdditionally if you'd like to contribute to the library please feel free to open up a pull request! Just give me a heads up first though (via issues or comments) so we don't overwrite each other in the event I am updating the project.\n\n**Special thanks to all those who have supported this repo thus far!**\n\n\u003cp align=\"center\"\u003e\n    \u003ca href=\"https://github.com/MackHartley/RoundedProgressBar/stargazers\"\u003e\u003cimg src=\"http://reporoster.com/stars/MackHartley/RoundedProgressBar\"/\u003e\u003c/a\u003e\n    \u003cbr\u003e\n    \u003ca href=\"https://github.com/MackHartley/RoundedProgressBar/network/members\"\u003e\u003cimg src=\"http://reporoster.com/forks/MackHartley/RoundedProgressBar\"/\u003e\u003c/a\u003e\n    \u003cbr\u003e\n    \u003cbr\u003e\n    \u003ci\u003eFeatured in \u003ca href=\"https://androidweekly.net/issues/issue-467\"\u003eAndroid Weekly\u003c/a\u003e, \u003ca href=\"https://android-arsenal.com/details/1/8327\"\u003eAndroid Arsenal\u003c/a\u003e and \u003ca href=\"https://medium.com/@mmbialas/25-best-android-libraries-projects-and-tools-you-dont-want-to-miss-in-2021-681dafe58b1c\"\u003eMedium\u003c/a\u003e\u003c/i\u003e.\n\u003c/p\u003e\n\n# License 📄\n```\nCopyright 2021 Mack Hartley\n\nLicensed under the Apache License, Version 2.0 (the \"License\");\nyou may not use this file except in compliance with the License.\nYou may obtain a copy of the License at\n\n   http://www.apache.org/licenses/LICENSE-2.0\n\nUnless required by applicable law or agreed to in writing, software\ndistributed under the License is distributed on an \"AS IS\" BASIS,\nWITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.\nSee the License for the specific language governing permissions and\nlimitations under the License.\n```\n","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2FMackHartley%2FRoundedProgressBar","html_url":"https://awesome.ecosyste.ms/projects/github.com%2FMackHartley%2FRoundedProgressBar","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2FMackHartley%2FRoundedProgressBar/lists"}