https://github.com/mueller-ma/PrepaidBalance

App to check your prepaid balance
https://github.com/mueller-ma/PrepaidBalance

android kotlin

Last synced: about 2 months ago
JSON representation

App to check your prepaid balance

• Host: GitHub
• URL: https://github.com/mueller-ma/PrepaidBalance
• Owner: mueller-ma
• License: apache-2.0
• Created: 2021-05-16T16:25:32.000Z (over 3 years ago)
• Default Branch: main
• Last Pushed: 2024-11-06T19:18:45.000Z (2 months ago)
• Last Synced: 2024-11-07T17:59:15.906Z (2 months ago)
• Topics: android, kotlin
• Language: Kotlin
• Homepage:
• Size: 2.28 MB
• Stars: 36
• Watchers: 3
• Forks: 12
• Open Issues: 3
• Metadata Files:
  • Readme: README.md
  • License: LICENSE
  • Security: SECURITY.md

Awesome Lists containing this project

README

        
# Prepaid balance

[![Build App](https://github.com/mueller-ma/PrepaidBalance/actions/workflows/build.yml/badge.svg)](https://github.com/mueller-ma/PrepaidBalance/actions/workflows/build.yml)

[![CodeFactor](https://www.codefactor.io/repository/github/mueller-ma/prepaidbalance/badge)](https://www.codefactor.io/repository/github/mueller-ma/prepaidbalance)

[![Crowdin](https://badges.crowdin.net/prepaidbalance/localized.svg)](https://crowdin.com/project/prepaidbalance)

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.

[](https://f-droid.org/de/packages/com.github.muellerma.prepaidbalance/)[](https://github.com/mueller-ma/PrepaidBalance/releases)



## Maintenance notice

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

## 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](https://crowdin.com/profile/mueller-ma) 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](https://github.com/mueller-ma/PrepaidBalance/issues/81#issuecomment-1131516634) 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.

* `POST_NOTIFICATIONS`: Used to display notifications about your balance.

* `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.

## Credits

* Feature graphic by https://unsplash.com/@joshappel