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
307 Commits 13 Branches 35 Tags 3 MiB
Kotlin 100%
e6a7062773
Go to file
dependabot[bot] e6a7062773
Bump actions/stale from 8 to 9 (#269) 
Bumps [actions/stale](https://github.com/actions/stale) from 8 to 9.
- [Release notes](https://github.com/actions/stale/releases)
- [Changelog](https://github.com/actions/stale/blob/main/CHANGELOG.md)
- [Commits](https://github.com/actions/stale/compare/v8...v9)

---
updated-dependencies:
- dependency-name: actions/stale
  dependency-type: direct:production
  update-type: version-update:semver-major
...

Signed-off-by: dependabot[bot] <support@github.com>
Co-authored-by: dependabot[bot] <49699333+dependabot[bot]@users.noreply.github.com>
2024-02-01 17:51:31 +01:00
.github Bump actions/stale from 8 to 9 (#269) 2024-02-01 17:51:31 +01:00
.idea Prepare for Android 14 (#251) 2023-11-05 12:18:40 +01:00
app Bump androidx.fragment:fragment-ktx from 1.6.1 to 1.6.2 (#259) 2023-12-12 21:57:49 +01:00
fastlane/metadata/android Bump to 2.5 2023-11-20 21:06:46 +01: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 room_version from 2.6.0 to 2.6.1 (#261) 2023-12-12 22:03:41 +01: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