This app keeps track of your prepaid balance. It can automatically record it and post a notification if your balance drops under a configurable threshold. It does so by parsing the response of a USSD code, that can be set in the settings.
From my point of view this app is feature complete. I probably won't add new major features on my own, but I will:
- Keep dependencies up-to-date
- Merge new translations
- Fix bugs
- Review and merge PRs, even for new features
App strings and the app store description can be translated via Crowdin: https://crowdin.com/project/prepaidbalance
Translations 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 or open an issue here on GitHub.
You might run into on of these issues with the app:
- 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.
- Your provider doesn't provide a USSD code to query your prepaid balance. In this case you cannot use this app.
- 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 for more details.
- Depending on the response pattern the parsing might fail. In this case please open an issue.
- Add a new
MatchertoMATCHERSinReponseParser.kt - Add your USSD code to
testGetBalance()inResponseParserTest.kt - Check if all test succeed
CALL_PHONE: Used to query USSD codes.POST_NOTIFICATIONS: Used to display notifications about your balance.ACCESS_NETWORK_STATE,RECEIVE_BOOT_COMPLETED,FOREGROUND_SERVICE,WAKE_LOCK: Used by WorkManager to ensure work constraints are met and running workers aren't killed.
- Feature graphic by https://unsplash.com/@joshappel