mirror/PrepaidBalance
0
0
Fork 0
mirror of https://github.com/mueller-ma/PrepaidBalance.git synced 2024-09-19 16:02:14 +02:00
Code
App to check your prepaid balance
280 Commits 13 Branches 35 Tags 3 MiB
Kotlin 100%
7f38ba1fdb
Go to file
dependabot[bot] 7f38ba1fdb
Bump com.android.tools.build:gradle from 8.0.2 to 8.1.0 (#235) 
Bumps com.android.tools.build:gradle from 8.0.2 to 8.1.0.

---
updated-dependencies:
- dependency-name: com.android.tools.build:gradle
  dependency-type: direct:production
  update-type: version-update:semver-minor
...

Signed-off-by: dependabot[bot] <support@github.com>
Co-authored-by: dependabot[bot] <49699333+dependabot[bot]@users.noreply.github.com>
2023-08-02 20:17:33 +02:00
.github Fix CI (#225) 2023-05-23 16:08:20 +02:00
.idea Update Gradle to 8.0 and AS to Flamingo (#219) 2023-04-25 12:12:34 +02:00
app Bump androidx.fragment:fragment-ktx from 1.5.7 to 1.6.0 (#231) 2023-07-03 19:44:59 +02:00
fastlane/metadata/android New Crowdin updates (#224) 2023-05-16 07:57:53 +02:00
gradle/wrapper Update Gradle to 8.0 and AS to Flamingo (#219) 2023-04-25 12:12:34 +02:00
.editorconfig Add .editorconfig 2022-11-17 08:31:37 +01:00
.gitignore Gitignore .idea/androidTestResultsUserPreferences.xml 2022-10-05 10:54:01 +02:00
build.gradle Bump com.android.tools.build:gradle from 8.0.2 to 8.1.0 (#235) 2023-08-02 20:17:33 +02:00
crowdin.yml Add title.txt to Fastlane metadata 2022-05-01 19:16:50 +02:00
gradle.properties Update Gradle to 8.0 and AS to Flamingo (#219) 2023-04-25 12:12:34 +02:00
gradlew Inital commit 2021-05-16 18:26:18 +02:00
gradlew.bat Inital commit 2021-05-16 18:26:18 +02:00
LICENSE Inital commit 2021-05-16 18:26:18 +02:00
README.md Update badges in README 2023-04-01 11:03:23 +02:00
SECURITY.md Inital commit 2021-05-16 18:26:18 +02:00
settings.gradle Inital commit 2021-05-16 18:26:18 +02:00

README.md

Prepaid balance

Build App CodeFactor Crowdin

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.

Get it on F-DroidDownload from GitHub

Screenshot

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 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.
  • 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.

Credits