0
0
mirror of https://github.com/mueller-ma/PrepaidBalance.git synced 2024-09-20 08:22:12 +02:00
PrepaidBalance/README.md

35 lines
2.1 KiB
Markdown
Raw Normal View History

2021-05-16 18:26:18 +02:00
# Prepaid balance
2022-01-25 21:48:51 +01:00
[![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)
2021-05-16 18:26:18 +02:00
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.
[<img src="https://f-droid.org/badge/get-it-on.png" alt="Get it on F-Droid" height="80">](https://f-droid.org/de/packages/com.github.muellerma.prepaidbalance/)
2022-05-01 19:13:16 +02:00
<img src="fastlane/metadata/android/en-US/images/phoneScreenshots/1.png" alt="Screenshot" width=200px>
2021-05-16 18:26:18 +02:00
## Translations
2022-01-13 11:46:05 +01:00
App strings and the app store description can be translated via Crowdin: https://crowdin.com/project/prepaidbalance
2021-05-16 18:26:18 +02:00
2022-01-13 11:46:05 +01:00
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.
2021-05-16 18:26:18 +02:00
## Troubleshooting
You might run into on of these issues with the app:
* The USSD code is different than the default (`*100#`). 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.
* Depending on the response pattern the parsing might fail. In this case please open an issue.
2021-06-08 10:39:11 +02:00
## Android permissions
* `CALL_PHONE`: Used to query USSD codes.
* `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.
2021-05-16 18:26:18 +02:00
## Credits
* Feature graphic by https://unsplash.com/@joshappel