osobotu/faranga

# Faranga Track your MoMo spending automatically. Private. Local. Free. Faranga reads your MTN Mobile Money SMS messages and turns them into organized, categorized financial data — entirely on your device. Nothing leaves your phone. Built for Rwanda, works with MTN MoMo. ## Features - **Automatic SMS parsing** — reads MoMo transaction messages (transfers, merchant payments, received money) - **Spending analytics** — daily, weekly, monthly totals with month-over-month trends - **Category breakdown** — auto-categorizes merchants (groceries, transport, utilities, etc.) - **Top recipients** — see where your money goes most - **Day-of-week patterns** — discover your spending habits - **Periodic sync** — auto-refreshes every 15 minutes while the app is open - **100% offline** — all data stays on your device in a local database ## Download > Requires Android 7.0+ (API 24). You may need to enable "Install from unknown sources" in your phone settings. 1. Download `app-arm64-v8a-release.apk` from the latest release 2. Android may block the install because the app requests SMS access. To install, temporarily disable Play Protect: **Play Store > Profile > Play Protect > Settings (gear icon) > Turn off/Pause scanning** 3. Install the APK, then re-enable Play Protect 4. Alternatively, install via USB with `adb install app-arm64-v8a-release.apk` ## Privacy MoMo Finance is designed with privacy as a core principle: - **No internet permission** — the app cannot send data anywhere - **No accounts** — no sign-up, no login - **Local database** — all transaction data is stored in SQLite on your device - **SMS read-only** — the app reads messages but never sends or modifies them - **Open source** — inspect the code yourself ## Supported message formats | Type | Example | |---|---| | P2P Transfer | `*165*S*2200 RWF transferred to Name (250...) at ...` | | Merchant Payment | `TxId:...*S*Your payment of 3,300 RWF to SHOP NAME ...` | | Received Money | `You have received …