Skip to content
02Getting started

Set Ledgerly up.

Eight steps. Three are optional. The first time through takes around five minutes, and you can walk out of it with months of history already in the ledger.

01

Install Ledgerly

Ledgerly is in closed testing on Google Play. Join the beta with the beta form and we add you to the tester list. Open the opt-in link we send, and Google Play installs Ledgerly and keeps it updated like any other app.

The app installs as com.madmaxlabs.ledgerly. Ledgerly runs on Android 8.0 (2017) or newer.

Join the beta

Or join the waitlist: one email when Ledgerly is on Google Play. Nothing else, ever.

02

Allow SMS reading

On first launch, Ledgerly asks for permission to read incoming SMS. Allow it and your ledger starts filling itself the next time your bank sends a transaction message.

What this gets you
  • Incoming bank SMS gets parsed into clean transactions on your device.
  • Promotional and personal SMS is ignored. Only messages that match transaction patterns are kept.
  • Only the parsed details are stored: amount, merchant, date, bank, last four of the card. The original SMS text is discarded.
What it does not do
  • Live capture covers new messages from the moment you allow it. Your existing inbox is read only if you choose to run the one-time import in the next step, and never in the background.
  • SMS does not leave your device. No Ledgerly server ever sees a message.
  • You can revoke this any time in Android settings.
03

Import your SMS history

Optional

Right after you allow SMS, Ledgerly offers to import the bank messages already sitting in your inbox, so you start with months of real history instead of an empty ledger. Pick a window (30, 60, or 90 days, or everything), scan, and review what it found, grouped by month. Nothing is saved until you confirm.

Skipped it at setup? Run it any time from Settings > Capture > Import SMS history. An import can also be removed afterwards from the same place, in one tap.

What this gets you
  • Your last few months of spending appear in the ledger on day one, before your bank has sent a single new SMS.
  • Bank debits and credits only. Personal and promotional messages are ignored.
  • Transactions Ledgerly already tracks are skipped automatically, and possible duplicates are shown to you to decide.
What it does not do
  • It reads your inbox once, on your device, only when you run it. Your messages are never uploaded.
  • It does not touch the transactions and balances you already have.
  • It never runs in the background or without you starting it.
04

Check your bank sender IDs

Indian banks send SMS from sender IDs like HDFCBK, JD-HDFCBK, or VK-HDFCBK depending on your operator. Ledgerly canonicalizes them all to the same bank, but the first time you run the app, take a moment to confirm the senders it detected look right.

If a transaction shows up with the wrong bank or no bank, you can correct the mapping. Future messages from that sender will use the correction.

05

Add your credit cards

Open the Cards section and add the cards you actually use. Two ways:

  • From the bundled catalog: 67 cards across HDFC, ICICI, SBI, Axis, IndusInd, Standard Chartered, and more. Each carries its real reward rates, caps, and exclusions.
  • Auto-detect: if your bank SMS has named a card, Ledgerly offers to add it for you.

Adding cards turns on the optimizer, the Cashback Bank, Card Karma, Welcome Bonus Radar, and the rest of the credit-card features. Without cards in your wallet, those screens stay quiet.

06

Turn on the accessibility helper

Optional

This step is optional. Skip it and the rest of the app still works fine.

If you turn it on, Ledgerly can read the item details inside the supported shopping apps, so a single Blinkit or Swiggy order becomes an itemized list in your ledger, with packaging fees and tip broken out. In the Google Play app, the helper never taps, scrolls or types inside another app.

Depth varies by app: Blinkit, Swiggy, Instamart, Zomato, Amazon Now, and Uber Eats get full itemized capture. For Zepto, Amazon, and Amazon Fresh, Ledgerly takes a screenshot of the order when you ask and turns it into an entry for you to review. Uber Eats orders are captured in dollars and converted to rupees at a rate you can adjust.

To enable: Settings > Accessibility > Ledgerly. Android will show its own warning about the powers an accessibility service has. That warning exists because the API can be misused; the way Ledgerly uses it is described below and in the privacy policy.

If Android shows “Restricted setting” instead, read why Android restricts these permissions and when to leave them blocked. The guide explains the difference between a Google Play install and a downloaded APK before you change anything.

One phone-specific note: aggressive battery savers on Xiaomi, Oppo, Vivo, and similar phones can freeze the capture helper after a few hours. Ledgerly runs a small keep-alive notification to prevent this and shows a Restart prompt if the helper does get frozen. If capture keeps stopping, allow Autostart for Ledgerly and set battery saver to No restrictions in your phone’s settings.

What this gets you
  • Reads screens only inside a built-in list of shopping apps, and captures orders from Blinkit, Swiggy, Instamart, Zomato, Amazon Now, Uber Eats, Zepto, Amazon, and Amazon Fresh.
  • While it is on, it reads those apps’ screens as you use them. An order is saved only when you tap the capture button or the Quick Settings tile and confirm it.
  • A notification stays up while the capture helper runs, so you can always see it. Stop helper in that notification, Pause capture in Settings, or the Capture on/off tile turns it off.
What it does not do
  • It does not read banking apps, messaging apps, or anything else.
  • Captured orders are saved on your phone. Cloud AI, if you turn it on, can use them to answer your questions.
  • The pre-swipe card nudge is not in the Google Play app. It is part of the direct-download edition only.
07

Turn on the AI features

Optional

Also optional. Skip it and every non-AI feature still works, with nothing sent to an AI model.

Cloud AI unlocks: the AI insight narrator (a plain-language story of your month), the Card Concierge chat (questions answered against your real wallet), Wallet Roast (the playful version), the loan-reminder drafter (ready-to-send nudges), the goal price estimator (a suggested target amount for a savings goal), and AI-assisted receipt and statement imports.

In the Google Play beta, invited testers get cloud AI through a tester pass with daily limits. There is no OpenAI key to add and nothing to buy inside the app.

Where to turn it on: Settings > AI. Activate your tester pass, then read and accept the cloud AI disclosure. The pass alone does not switch AI on.

What this gets you
  • Requests go through Ledgerly’s own service to a hosted model. The model credentials stay on that server, never on your phone.
  • What gets sent depends on the question: transactions, items, merchants, categories, budgets, card details and earlier chat messages can all be part of a request, not only totals. The text of your SMS and payment notifications is never sent.
  • Receipts are read on your phone unless you also turn on receipt uploads in Settings > AI. With uploads on, receipt photos go to cloud AI, and so do PDFs of up to four pages and 5 MB; longer PDFs are still read on your phone.
What it does not do
  • Ledgerly keeps access and usage records to run the tester allowance, plus technical logs to fix failures. The privacy policy names the providers and what each one keeps.
  • Once cloud AI is on, background helpers such as the daily brief can send data while the app is closed. Each one can be switched off in AI settings.
  • To turn AI off, switch cloud AI off in Settings > AI. New requests stop at once; a request already sent cannot be recalled.
08

Take a first look around

The four screens worth knowing about on day one:

  • Dashboard. Balance, monthly spend against budget, the cash-flow forecast, the Cashback Bank tally, today’s card.
  • History. Every transaction, ordered by day. Long-press a row to recategorize, mark it as a subscription or a loan, classify inflow (refund, gift, borrowed), or edit the amount.
  • Insights. Monthly headline, trend lines, fee totals, top items, and a plain-English summary of the month.
  • Settings. Permissions, AI, accessibility opt-ins, backup, integrity check.

Once you have a few weeks of data in it (or months, if you ran the history import), visit Settings, Data and take your first backup. It is one file, and it is yours. There is also a full dark mode, in Settings, General.

Want more detail?

The features page walks through every screen, with examples.