prepaidbalance's Introduction

Prepaid balance

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.

Translations

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.

Troubleshooting

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.

Development

Fix parsing of an USSD code response

Add a new Matcher to MATCHERS in ReponseParser.kt
Add your USSD code to testGetBalance() in ResponseParserTest.kt
Check if all test succeed

Android permissions

CALL_PHONE: Used to query USSD codes.
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.