{"id":17164960,"url":"https://github.com/mueller-ma/prepaidbalance","last_synced_at":"2025-08-22T05:30:56.568Z","repository":{"id":37518901,"uuid":"367932135","full_name":"mueller-ma/PrepaidBalance","owner":"mueller-ma","description":"App to check your prepaid balance","archived":false,"fork":false,"pushed_at":"2024-11-06T19:18:45.000Z","size":2393,"stargazers_count":37,"open_issues_count":3,"forks_count":11,"subscribers_count":3,"default_branch":"main","last_synced_at":"2024-12-10T03:40:31.721Z","etag":null,"topics":["android","kotlin"],"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/mueller-ma.png","metadata":{"files":{"readme":"README.md","changelog":null,"contributing":null,"funding":null,"license":"LICENSE","code_of_conduct":null,"threat_model":null,"audit":null,"citation":null,"codeowners":null,"security":"SECURITY.md","support":null,"governance":null,"roadmap":null,"authors":null,"dei":null,"publiccode":null,"codemeta":null}},"created_at":"2021-05-16T16:25:32.000Z","updated_at":"2024-11-10T05:14:01.000Z","dependencies_parsed_at":"2023-02-19T09:31:10.812Z","dependency_job_id":"ef497133-4def-4ba0-a299-4ea3812651d7","html_url":"https://github.com/mueller-ma/PrepaidBalance","commit_stats":null,"previous_names":[],"tags_count":36,"template":false,"template_full_name":null,"repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/mueller-ma%2FPrepaidBalance","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/mueller-ma%2FPrepaidBalance/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/mueller-ma%2FPrepaidBalance/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/mueller-ma%2FPrepaidBalance/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/mueller-ma","download_url":"https://codeload.github.com/mueller-ma/PrepaidBalance/tar.gz/refs/heads/main","host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":230561013,"owners_count":18245324,"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","kotlin"],"created_at":"2024-10-14T22:53:15.332Z","updated_at":"2024-12-20T09:06:14.971Z","avatar_url":"https://github.com/mueller-ma.png","language":"Kotlin","funding_links":[],"categories":[],"sub_categories":[],"readme":"# Prepaid balance\n\n[![Build App](https://github.com/mueller-ma/PrepaidBalance/actions/workflows/build.yml/badge.svg)](https://github.com/mueller-ma/PrepaidBalance/actions/workflows/build.yml)\n[![CodeFactor](https://www.codefactor.io/repository/github/mueller-ma/prepaidbalance/badge)](https://www.codefactor.io/repository/github/mueller-ma/prepaidbalance)\n[![Crowdin](https://badges.crowdin.net/prepaidbalance/localized.svg)](https://crowdin.com/project/prepaidbalance)\n\nThis app keeps track of your prepaid balance. It can automatically record it and post a notification if your balance drops under a configurable threshold.\nIt does so by parsing the response of a USSD code, that can be set in the settings.\n\n[\u003cimg alt=\"Get it on F-Droid\" height=\"80\" src=\"https://raw.githubusercontent.com/mueller-ma/android-common/main/assets/get-it-on-fdroid.png\"/\u003e](https://f-droid.org/de/packages/com.github.muellerma.prepaidbalance/)[\u003cimg alt=\"Download from GitHub\" height=\"80\" src=\"https://raw.githubusercontent.com/mueller-ma/android-common/main/assets/direct-apk-download.png\"/\u003e](https://github.com/mueller-ma/PrepaidBalance/releases)\n\n\u003cimg src=\"fastlane/metadata/android/en-US/images/phoneScreenshots/1.png\" alt=\"Screenshot\" width=200px\u003e\n\n## Maintenance notice\n\nFrom my point of view this app is feature complete. I probably won't add new major features on my own, but I will:\n* Keep dependencies up-to-date\n* Merge new translations\n* Fix bugs\n* Review and merge PRs, even for new features\n\n## Translations\n\nApp strings and the app store description can be translated via Crowdin: https://crowdin.com/project/prepaidbalance\n\nTranslations have to be approved before being merged into the app. To become a translator with approval rights or to request a new language, please [poke me on Crowdin](https://crowdin.com/profile/mueller-ma) or open an issue here on GitHub. \n\n## Troubleshooting\n\nYou might run into on of these issues with the app:\n* The USSD code is different than the default. In this case please configure the correct one and open an issue, so I can change the default code for your provider. \n* Your provider doesn't provide a USSD code to query your prepaid balance. In this case you cannot use this app.\n* The USSD code to query the balance is \"menu based\", i.e. if you enter it in the dialer app, you get a menu. See [this issue](https://github.com/mueller-ma/PrepaidBalance/issues/81#issuecomment-1131516634) for more details.\n* Depending on the response pattern the parsing might fail. In this case please open an issue.\n\n## Development\n\n### Fix parsing of an USSD code response\n\n* Add a new `Matcher` to `MATCHERS` in `ReponseParser.kt`\n* Add your USSD code to `testGetBalance()` in `ResponseParserTest.kt`\n* Check if all test succeed\n\n## Android permissions\n\n* `CALL_PHONE`: Used to query USSD codes.\n* `POST_NOTIFICATIONS`: Used to display notifications about your balance.\n* `ACCESS_NETWORK_STATE`, `RECEIVE_BOOT_COMPLETED`, `FOREGROUND_SERVICE`, `WAKE_LOCK`: Used by [WorkManager](https://developer.android.com/reference/androidx/work/WorkManager) to ensure work constraints are met and running workers aren't killed.\n\n## Credits\n\n* Feature graphic by https://unsplash.com/@joshappel\n","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fmueller-ma%2Fprepaidbalance","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Fmueller-ma%2Fprepaidbalance","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fmueller-ma%2Fprepaidbalance/lists"}